JotForm API - Python Client & MCP Server

by The-AI-Workshops

219 downloads
Not rated
GitHub

About

MCP Server for interacting with the Jotform API, generated from the original Python client.

Details

Author
The-AI-Workshops
Downloads
219
Categories
Productivity, Other, Automation, API, Developer Tools

- Exposes 50+ tools for JotForm operations.
- Supports user, form, submission, folder, and report management.
- Custom search_submissions_by_date tool for date‑based searches.
- SSE and stdio transport options.
- Runs locally, via Smithery, or in Docker.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name JotForm API - Python Client & MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

You can install it via Smithery by searching for “JotForm API Server” and setting the JOTFORM_API_KEY environment variable. Alternatively, clone the repository, create a virtual environment, install dependencies (with uv or pip), configure a .env file with your API key, and run python jotform_mcp_server.py. A Dockerfile is also provided for containerized deployment. Use SSE (http://localhost:8067/sse) or stdio transport to connect your MCP client.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "jotform api - python client & mcp server": {
            "jotform-mcp-server": {
                "command": "python3",
                "args": [
                    "-m",
                    "venv",
                    "venv"
                ]
            }
        }
    }
}

McpServers

{
    "jotform-mcp-server": {
        "command": "python3",
        "args": [
            "-m",
            "venv",
            "venv"
        ]
    }
}

JotForm API - Python Client & MCP Server

This repository contains the Python client for the JotForm API and an MCP (Model Context Protocol) server built using this client. The MCP server allows interaction with the Jotform API through standardized tools.

Installation via Smithery (Recommended for MCP Clients)

This server is available on Smithery. You can easily install and configure it within compatible MCP clients (like Windsurf):

1. Search: In your MCP client's server management interface, search for servers.
2. Find: Look for JotForm API Server or use the ID @The-AI-Workshops/jotform-mcp-server.
3. Install: Select the server and click "Install".
4. Configure: After installation, you will be prompted to configure the required environment variables. The most important one is:
JOTFORM_API_KEY: Your Jotform API key.

Smithery handles the underlying setup (Docker or Python environment) based on the server's configuration.

Authentication

JotForm API requires an API key for all user-related calls. You can create your API Keys at the API section of your JotForm account settings. This key is needed to run the MCP server, whether installed manually or via Smithery.

Manual Setup and Running (for Development or Non-Smithery Use)

1. Clone the Repository:

git clone https://github.com/The-AI-Workshops/jotform-mcp-server.git
cd jotform-mcp-server

2. Create Virtual Environment (Recommended):

python3 -m venv venv
source venv/bin/activate  # On Windows use venv\Scripts\activate

3. Install Dependencies:

Choose one of the following methods:

Using uv (Recommended):
If you don't have uv, install it: pip install uv
Install dependencies using the lock file for reproducibility:

        uv pip sync uv.lock

Using pip:
Install dependencies using the requirements.txt file:

        pip install -r requirements.txt

4. Configure API Key:

Rename the .env.example file to .env.
Open the .env file and replace "YOUR_JOTFORM_API_KEY_HERE" with your actual Jotform API key.

  • You can also adjust other settings like MCP_PORT or JOTFORM_BASE_URL if needed.


```dotenv

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.