Clappia MCP server

Clappia MCP (Model Context Protocol)

A Python-based MCP server that provides a comprehensive interface for interacting with the Clappia platform. This server enables programmatic management of Clappia applications, forms, submissions, and more.

Clappia is a no-code platform that allows businesses, operations teams, and non-developers to create custom apps—like inspection forms, approval workflows, field data collection tools, internal dashboards, and more—without writing a single line of code. It's used across industries for automating manual processes, digitizing paperwork, and improving operational efficiency. Click here to learn more.

Features

• App Management

• Create new Clappia apps with customizable sections and fields

• Retrieve detailed app definitions with field metadata

• Submission Management

• Create new submissions with field data
• Edit existing submissions with validation
• Update submission status with optional comments
• Manage submission owners with email-based assignments
• Retrieve submissions with advanced filtering and pagination
• Get submission aggregations for analytics with customizable dimensions

• Field Management
• Add new fields with comprehensive configuration options
• Update field properties including validation, display conditions, and layout
• Configure field validations (number, email, URL, custom)
• Set up conditional logic for field display and editability
• Manage field layouts with responsive design options

Prerequisites

• Python 3.8 or higher
• uv python package manager
• Access to Clappia API Key and Workplace ID
• Claude for Desktop (or any other MCP Clients)

Installation

1. Set up Clappia API Access:

• Visit your Workplace in Clappia (https://.clappia.com), you need to have Workplace Manager Access to this Workplace.
• Visit Workplace Settings. Note your Workplace ID.
• Visit Workplace Settings -> Preferences -> API Keys. Note your API Key, generate one if it is not yet generated.

1. Set up Claude for Desktop:

• Download Claude for Desktop for macOS or Windows
• Install and launch Claude for Desktop
• Open Claude menu → Settings → Developer → Edit Config
• Add the following configuration to claudedesktopconfig.json:

{
         "mcpServers": {
            "clappia-mcp": {
               "command": "uv",
               "args": [
                  "--directory",
                  "/Users/<YOUR_DIECTORY>/Desktop/clappia-mcp",
                  "run",
                  "clappia-mcp.py"
               ],
               "env": {
                  "CLAPPIA_API_KEY": "<ENTER_YOUR_WORKPLACE_API_KEY_HERE>",
                  "CLAPPIA_WORKPLACE_ID": "<ENTER_YOUR_WORKPLACE_ID_HERE>"
               }
            }
         }
      }

• Restart Claude for Desktop
• Verify the MCP server is running by checking for the tools icon in the input box

1. Clone the repository:

git clone https://github.com/clappia-dev/clappia-mcp.git
   cd clappia-mcp

1. Set up Python Environment:

# Install uv if not already installed
   curl -LsSf https://astral.sh/uv/install.sh | sh

   # Install dependencies
   uv sync

Project Structure

Shortened. The full README is on GitHub.