Skip to content
MCP server

Frappe MCP Server

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.2.0
Listing updated
6 days ago

About Frappe MCP Server

Frappe MCP Server is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Install

Run in a terminal

claude mcp add frappe_mcp --env FRAPPE_URL='<FRAPPE_URL>' --env FRAPPE_API_KEY='<FRAPPE_API_KEY>' --env FRAPPE_API_SECRET='<FRAPPE_API_SECRET>' -- uvx frappe-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "frappe_mcp": {
      "command": "uvx",
      "args": [
        "frappe-mcp-server"
      ],
      "env": {
        "FRAPPE_URL": "<FRAPPE_URL>",
        "FRAPPE_API_KEY": "<FRAPPE_API_KEY>",
        "FRAPPE_API_SECRET": "<FRAPPE_API_SECRET>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "frappe_mcp": {
      "command": "uvx",
      "args": [
        "frappe-mcp-server"
      ],
      "env": {
        "FRAPPE_URL": "<FRAPPE_URL>",
        "FRAPPE_API_KEY": "<FRAPPE_API_KEY>",
        "FRAPPE_API_SECRET": "<FRAPPE_API_SECRET>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "frappe_mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "frappe-mcp-server"
      ],
      "env": {
        "FRAPPE_URL": "<FRAPPE_URL>",
        "FRAPPE_API_KEY": "<FRAPPE_API_KEY>",
        "FRAPPE_API_SECRET": "<FRAPPE_API_SECRET>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "frappe_mcp": {
      "command": "uvx",
      "args": [
        "frappe-mcp-server"
      ],
      "env": {
        "FRAPPE_URL": "<FRAPPE_URL>",
        "FRAPPE_API_KEY": "<FRAPPE_API_KEY>",
        "FRAPPE_API_SECRET": "<FRAPPE_API_SECRET>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "frappe_mcp": {
      "command": "uvx",
      "args": [
        "frappe-mcp-server"
      ],
      "env": {
        "FRAPPE_URL": "<FRAPPE_URL>",
        "FRAPPE_API_KEY": "<FRAPPE_API_KEY>",
        "FRAPPE_API_SECRET": "<FRAPPE_API_SECRET>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • FRAPPE_URLBase URL of your Frappe/ERPNext site, e.g. https://your-site.erpnext.comRequired
  • FRAPPE_API_KEYFrappe API key for token-based authenticationRequired
  • FRAPPE_API_SECRETFrappe API secret paired with the API keyRequired
  • FRAPPE_VERIFY_SSLSet to 'false' to skip TLS certificate verification. Defaults to 'true'.
  • FRAPPE_TIMEOUTPer-request timeout in seconds. Defaults to 30.
  • FRAPPE_URLBase URL of your Frappe/ERPNext site, e.g. https://your-site.erpnext.comRequired
  • FRAPPE_API_KEYFrappe API key for token-based authenticationRequired
  • FRAPPE_API_SECRETFrappe API secret paired with the API keyRequired
  • FRAPPE_VERIFY_SSLSet to 'false' to skip TLS certificate verification. Defaults to 'true'.
  • FRAPPE_TIMEOUTPer-request timeout in seconds. Defaults to 30.
  • FRAPPE_URLBase URL of your Frappe/ERPNext site, e.g. https://your-site.erpnext.comRequired
  • FRAPPE_API_KEYFrappe API key for token-based authenticationRequired
  • FRAPPE_API_SECRETFrappe API secret paired with the API keyRequired
  • FRAPPE_VERIFY_SSLSet to 'false' to skip TLS certificate verification. Defaults to 'true'.
  • FRAPPE_TIMEOUTPer-request timeout in seconds. Defaults to 30.

Pricing

Open source

Frappe MCP Server FAQ

Is Frappe MCP Server free?

Yes. Frappe MCP Server is open source, so you can use and self-host it for free.

How do I add Frappe MCP Server to Claude Code?

Run this command in your terminal: claude mcp add frappe_mcp --env FRAPPE_URL='<FRAPPE_URL>' --env FRAPPE_API_KEY='<FRAPPE_API_KEY>' --env FRAPPE_API_SECRET='<FRAPPE_API_SECRET>' -- uvx frappe-mcp-server

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers