Frappe MCP Server: Install & Setup

Install Frappe in Claude Code

PyPI (uv)

Claude Code

claude mcp add frappe -e FRAPPE_URL=... -e FRAPPE_API_KEY=... -e FRAPPE_API_SECRET=... -- uvx frappe-mcp-server

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

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

Docker

Claude Code

claude mcp add frappe -e FRAPPE_URL=... -e FRAPPE_API_KEY=... -e FRAPPE_API_SECRET=... -- docker run -i --rm -e FRAPPE_URL -e FRAPPE_API_KEY -e FRAPPE_API_SECRET docker.io/muthanii/frappe-mcp:1.2.0

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

{
  "mcpServers": {
    "frappe": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "FRAPPE_URL",
        "-e",
        "FRAPPE_API_KEY",
        "-e",
        "FRAPPE_API_SECRET",
        "docker.io/muthanii/frappe-mcp:1.2.0"
      ],
      "env": {
        "FRAPPE_URL": "...",
        "FRAPPE_API_KEY": "...",
        "FRAPPE_API_SECRET": "..."
      }
    }
  }
}

Docker

Claude Code

claude mcp add frappe -e FRAPPE_URL=... -e FRAPPE_API_KEY=... -e FRAPPE_API_SECRET=... -- docker run -i --rm -e FRAPPE_URL -e FRAPPE_API_KEY -e FRAPPE_API_SECRET ghcr.io/muthanii/frappe-mcp:1.2.0

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

{
  "mcpServers": {
    "frappe": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "FRAPPE_URL",
        "-e",
        "FRAPPE_API_KEY",
        "-e",
        "FRAPPE_API_SECRET",
        "ghcr.io/muthanii/frappe-mcp:1.2.0"
      ],
      "env": {
        "FRAPPE_URL": "...",
        "FRAPPE_API_KEY": "...",
        "FRAPPE_API_SECRET": "..."
      }
    }
  }
}

Replace each ... with your own value.

Frequently asked questions

What does the Frappe MCP server do?

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

Is the Frappe MCP server free?

The server is free, but you will likely need an account. The server itself is free, but it connects to a service that needs an account or API key, which may have paid tiers. Check the provider for current pricing.

Does Frappe run locally or remotely?

Local. Runs on your machine (stdio). You install it with npx, uvx, Docker or from source.

How do I add Frappe to Claude Code?

Run: claude mcp add frappe -e FRAPPE_URL=... -e FRAPPE_API_KEY=... -e FRAPPE_API_SECRET=... -- uvx frappe-mcp-server

More search & web scraping MCP servers

View all

Frédérick Madore

fmadore/Website

Search and cite Frédérick Madore's publications, talks, research projects, DH work and CV.

LocalFree

Firecrawl

pipeworx-io/mcp-firecrawl

Firecrawl MCP — wraps the Firecrawl API (firecrawl.dev) for web scraping / crawling / search…

Local + RemoteFree

GA4 SEO

GermaniU/ga4-seo-mcp

Set up and audit site measurement: GA4, Search Console and PageSpeed. Read-only unless enabled.

LocalAccount needed

Files

Abhishekkumar2021/mcp-suite

Sandboxed local filesystem: read, search, edit, copy, archive, and safely manage files.

LocalFree

Gdpr Decisions

mister-franklin/mcp-gdpr-decisions

EU GDPR decisions by thedpo.eu — search all EU DPA decisions and recommendations

LocalAccount needed

Federal Reserve

cyanheads/federal-reserve-mcp-server

Search and fetch ~800K Federal Reserve economic time-series from the FRED API via MCP.

LocalAccount needed