English Français العربية

Frappe MCP Server

Official registry Search and web

Interact with Frappe/ERPNext sites — document CRUD, search, and whitelisted method calls

Source code Website Documentation

What can you do with Frappe MCP Server?

  • Document CRUD — get, create, update, delete Frappe doctypes
  • Search — full-text and filtered document search
  • Remote method calls — invoke any server-side Python method
  • Authentication — API key + secret (token-based auth)
  • Docker-first — single docker run command, no Python install needed

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package frappe-mcp-server
Claude Code 
claude mcp add frappe-mcp-server -e 'FRAPPE_URL=<FRAPPE_URL>' -e 'FRAPPE_API_KEY=<your frappe_api_key>' -e 'FRAPPE_API_SECRET=<your frappe_api_secret>' -e 'FRAPPE_VERIFY_SSL=true' -e 'FRAPPE_TIMEOUT=30' -- uvx frappe-mcp-server==1.2.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "frappe-mcp-server": {
            "command": "uvx",
            "args": [
                "frappe-mcp-server==1.2.0"
            ],
            "env": {
                "FRAPPE_URL": "<FRAPPE_URL>",
                "FRAPPE_API_KEY": "<your frappe_api_key>",
                "FRAPPE_API_SECRET": "<your frappe_api_secret>",
                "FRAPPE_VERIFY_SSL": "true",
                "FRAPPE_TIMEOUT": "30"
            }
        }
    }
}

Environment variables

  • FRAPPE_URL required Base URL of your Frappe/ERPNext site, e.g. https://your-site.erpnext.com
  • FRAPPE_API_KEY required secret Frappe API key for token-based authentication
  • FRAPPE_API_SECRET required secret Frappe API secret paired with the API key
  • FRAPPE_VERIFY_SSL Set to 'false' to skip TLS certificate verification. Defaults to 'true'.
  • FRAPPE_TIMEOUT Per-request timeout in seconds. Defaults to 30.
OCI package docker.io/muthanii/frappe-mcp:1.2.0
Claude Code 
claude mcp add frappe-mcp-server -e 'FRAPPE_URL=<FRAPPE_URL>' -e 'FRAPPE_API_KEY=<your frappe_api_key>' -e 'FRAPPE_API_SECRET=<your frappe_api_secret>' -e 'FRAPPE_VERIFY_SSL=true' -e 'FRAPPE_TIMEOUT=30' -- docker run -i --rm docker.io/muthanii/frappe-mcp:1.2.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "frappe-mcp-server": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "docker.io/muthanii/frappe-mcp:1.2.0"
            ],
            "env": {
                "FRAPPE_URL": "<FRAPPE_URL>",
                "FRAPPE_API_KEY": "<your frappe_api_key>",
                "FRAPPE_API_SECRET": "<your frappe_api_secret>",
                "FRAPPE_VERIFY_SSL": "true",
                "FRAPPE_TIMEOUT": "30"
            }
        }
    }
}

Environment variables

  • FRAPPE_URL required Base URL of your Frappe/ERPNext site, e.g. https://your-site.erpnext.com
  • FRAPPE_API_KEY required secret Frappe API key for token-based authentication
  • FRAPPE_API_SECRET required secret Frappe API secret paired with the API key
  • FRAPPE_VERIFY_SSL Set to 'false' to skip TLS certificate verification. Defaults to 'true'.
  • FRAPPE_TIMEOUT Per-request timeout in seconds. Defaults to 30.
OCI package ghcr.io/muthanii/frappe-mcp:1.2.0
Claude Code 
claude mcp add frappe-mcp-server -e 'FRAPPE_URL=<FRAPPE_URL>' -e 'FRAPPE_API_KEY=<your frappe_api_key>' -e 'FRAPPE_API_SECRET=<your frappe_api_secret>' -e 'FRAPPE_VERIFY_SSL=true' -e 'FRAPPE_TIMEOUT=30' -- docker run -i --rm ghcr.io/muthanii/frappe-mcp:1.2.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "frappe-mcp-server": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/muthanii/frappe-mcp:1.2.0"
            ],
            "env": {
                "FRAPPE_URL": "<FRAPPE_URL>",
                "FRAPPE_API_KEY": "<your frappe_api_key>",
                "FRAPPE_API_SECRET": "<your frappe_api_secret>",
                "FRAPPE_VERIFY_SSL": "true",
                "FRAPPE_TIMEOUT": "30"
            }
        }
    }
}

Environment variables

  • FRAPPE_URL required Base URL of your Frappe/ERPNext site, e.g. https://your-site.erpnext.com
  • FRAPPE_API_KEY required secret Frappe API key for token-based authentication
  • FRAPPE_API_SECRET required secret Frappe API secret paired with the API key
  • FRAPPE_VERIFY_SSL Set to 'false' to skip TLS certificate verification. Defaults to 'true'.
  • FRAPPE_TIMEOUT Per-request timeout in seconds. Defaults to 30.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. Frappe MCP Server
  2. Where to get it
  3. Features
  4. Quick start
  5. Available tools
  6. Configuration
  7. MCP client config
  8. Local development
  9. License

Frappe MCP Server

mcp-name: io.github.muthanii/frappe_mcp

A Model Context Protocol (MCP) server for Frappe Framework. Connect Claude Desktop, VS Code Copilot, and other MCP clients to any Frappe/ERPNext site via its REST API.

Where to get it

DistributionReferencePage
PyPIfrappe-mcp-serverpypi.org/project/frappe-mcp-server
Docker Hubmuthanii/frappe-mcphub.docker.com/r/muthanii/frappe-mcp
GitHub Container Registryghcr.io/muthanii/frappe-mcpghcr package
MCP Registryio.github.muthanii/frappe_mcpregistry API
Glama—glama.ai/mcp/servers/muthanii/frappe_mcp
Source—github.com/muthanii/frappe_mcp

Features

  • Document CRUD — get, create, update, delete Frappe doctypes
  • Search — full-text and filtered document search
  • Remote method calls — invoke any server-side Python method
  • Authentication — API key + secret (token-based auth)
  • Docker-first — single docker run command, no Python install needed

Quick start

With uvx (no install):

FRAPPE_URL=https://your-site.com \
FRAPPE_API_KEY=your-api-key \
FRAPPE_API_SECRET=your-api-secret \
  uvx frappe-mcp-server

With pip:

pip install frappe-mcp-server
frappe-mcp-server

With Docker (Docker Hub):

docker run -i --rm \
  -e FRAPPE_URL=https://your-site.com \
  -e FRAPPE_API_KEY=your-api-key \
  -e FRAPPE_API_SECRET=your-api-secret \
  muthanii/frappe-mcp

With Docker (GHCR):

docker run -i --rm \
  -e FRAPPE_URL=https://your-site.com \
  -e FRAPPE_API_KEY=your-api-key \
  -e FRAPPE_API_SECRET=your-api-secret \
  ghcr.io/muthanii/frappe-mcp

Available tools

Every tool ships MCP tool annotations and a declared outputSchema, so a client can tell read tools from destructive ones before calling them.

ToolDescriptionAccessDestructiveIdempotent
frappe_pingCheck connectivity and credentialsread-onlynoyes
frappe_get_docRetrieve a single document by doctype + nameread-onlynoyes
frappe_search_docsSearch/list documents with filtersread-onlynoyes
frappe_create_docCreate a new documentwritenono
frappe_update_docUpdate an existing documentwriteyesyes
frappe_delete_docDelete a document — irreversiblewriteyesno
frappe_run_methodCall a whitelisted server-side methodwriteyesno

frappe_run_method is marked destructive because its effect is determined entirely by the method you name.

Configuration

Environment variableRequiredDescription
FRAPPE_URLYesBase URL of your Frappe site (e.g. https://erp.example.com)
FRAPPE_API_KEYYesFrappe API key
FRAPPE_API_SECRETYesFrappe API secret
FRAPPE_VERIFY_SSLNoSet to false to skip TLS verification (default: true)
FRAPPE_TIMEOUTNoRequest timeout in seconds (default: 30)

MCP client config

Add this to your claude_desktop_config.json or Copilot config.

Via uvx:

{
  "mcpServers": {
    "frappe": {
      "command": "uvx",
      "args": ["frappe-mcp-server"],
      "env": {
        "FRAPPE_URL": "https://your-site.com",
        "FRAPPE_API_KEY": "your-api-key",
        "FRAPPE_API_SECRET": "your-api-secret"
      }
    }
  }
}

Via Docker:

{
  "mcpServers": {
    "frappe": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "FRAPPE_URL",
        "-e", "FRAPPE_API_KEY",
        "-e", "FRAPPE_API_SECRET",
        "muthanii/frappe-mcp"
      ],
      "env": {
        "FRAPPE_URL": "https://your-site.com",
        "FRAPPE_API_KEY": "your-api-key",
        "FRAPPE_API_SECRET": "your-api-secret"
      }
    }
  }
}

Local development

pip install -e .
frappe-mcp

License

MIT — see LICENSE.

Frequently asked questions

What is Frappe MCP Server?

Interact with Frappe/ERPNext sites — document CRUD, search, and whitelisted method calls

How do I install Frappe MCP Server?

It runs on your machine. In Claude Code: claude mcp add frappe-mcp-server -e 'FRAPPE_URL=<FRAPPE_URL>' -e 'FRAPPE_API_KEY=<your frappe_api_key>' -e 'FRAPPE_API_SECRET=<your frappe_api_secret>' -e 'FRAPPE_VERIFY_SSL=true' -e 'FRAPPE_TIMEOUT=30' -- uvx frappe-mcp-server==1.2.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Frappe MCP Server need an API key?

Yes. It expects FRAPPE_URL, FRAPPE_API_KEY, FRAPPE_API_SECRET, which you set in its configuration.

Is Frappe MCP Server open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Frappe MCP Server?

It is published by muthanii. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.