Skip to main content
Glama
muthanii

Frappe MCP Server

Frappe MCP Server

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.

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

Related MCP server: frappe-api-mcp

Quick start (Docker)

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

Available tools

Tool

Description

frappe_ping

Check connectivity to the Frappe site

frappe_get_doc

Retrieve a single document by doctype + name

frappe_search_docs

Search/list documents with filters

frappe_create_doc

Create a new document

frappe_update_doc

Update an existing document

frappe_delete_doc

Delete a document

frappe_run_method

Call a whitelisted server-side method

Configuration

Environment variable

Required

Description

FRAPPE_URL

Yes

Base URL of your Frappe site (e.g. https://erp.example.com)

FRAPPE_API_KEY

Yes

Frappe API key

FRAPPE_API_SECRET

Yes

Frappe API secret

FRAPPE_VERIFY_SSL

No

Set to false to skip TLS verification (default: true)

FRAPPE_TIMEOUT

No

Request timeout in seconds (default: 30)

MCP client config

Add this to your claude_desktop_config.json or Copilot config:

{
  "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.

MIT

Install Server
A
license - permissive license
A
quality
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/muthanii/frappe_mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server