LABSCO SUMMARY
Not just filing records — it can rebuild the form.
Most business-app integrations stop at reading and writing rows. This one also edits the app itself: adding fields, setting validation, changing layout and attaching conditional display rules. That is genuinely useful for iterating on an inspection form with a model, and it is also the reason to keep the API key scoped to a workplace you are willing to have restructured.
What it is
A Python MCP server over the Clappia platform's public API. Clappia is a no-code app builder used for inspection forms, approval workflows and field data collection; this server gives an assistant programmatic control over the apps, their fields, and the submissions that flow through them.
What you get
- App management: create a new Clappia app with sections and fields, and retrieve a detailed app definition including field metadata
- Submissions end to end — create one with field data, edit an existing one with validation, update its status with an optional comment, assign owners by email address, and retrieve submissions with advanced filtering and pagination
- Submission aggregations for analytics with customisable dimensions, rather than pulling every record and counting client-side
- Field management with the full configuration surface: add a field, update its properties, set validation (
number,email,url,customor none), and control layout with desktop and mobile block widths and column counts - Conditional logic on fields — a display condition and an editability condition, expressed against other field values
- The full Clappia field vocabulary, from
singleLineTextanddropDownthroughdateTime,file,cameraandsignaturetogpsLocation,codeScanner,nfcReader,liveTrackingandcalculationsAndLogic
Requirements
A Clappia workplace with Workplace Manager access, since both credentials come from Workplace Settings: the Workplace ID, and an API key generated under Preferences → API Keys. They go in the client config as CLAPPIA_API_KEY and CLAPPIA_WORKPLACE_ID. Python 3.8 or higher and the uv package manager; clone the repository, run uv sync, and launch it with uv --directory <YOUR_PATH_TO_CLAPPIA_MCP> run clappia-mcp.py. Calls are made over HTTPS against Clappia's public API, which has its own rate limits.
Setup effort
Build from source — git clone https://github.com/clappia-dev/clappia-mcp.git
USE CASES
01
Standing up a form from a description
Create the app with its sections and fields in one go instead of clicking through the builder.
02
Adding a field to a live app
Add it with its type, validation and layout widths, and attach a display condition so it only appears when it is relevant.
03
Filing and routing a submission
Create the submission with its field data, then set its status and assign an owner by email.
04
Answering a question about the data collected
Use aggregations with your own dimensions rather than paging through every submission to count them.
05
Finding the submissions that matter
Retrieve with filters and pagination, built from conditions on standard fields.
BEFORE YOU INSTALL
What to know first
Requires
- Python 3.8 or later
- CLAPPIA_API_KEY in your environment
- CLAPPIA_WORKPLACE_ID in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
git clone https://github.com/clappia-dev/clappia-mcp.git
cd clappia-mcp
# Install uv if not already installed
curl -LsSf https://astral.sh/uv/install.sh | sh
# Install dependencies
uv syncMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"clappia-mcp": {
"command": "uv",
"args": [
"--directory",
"<YOUR_PATH_TO_CLAPPIA_MCP>",
"run",
"clappia-mcp.py"
],
"env": {
"CLAPPIA_API_KEY": "<YOUR_CLAPPIA_API_KEY>",
"CLAPPIA_WORKPLACE_ID": "<YOUR_CLAPPIA_WORKPLACE_ID>"
}
}
}
}