How do I install Frappe ?

Frappe is a local plugin. Install it using PyPI package: frappe-mcp-server and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is Frappe safe to use?

Frappe scored 5.2/10 (moderate risk) in MCP Marketplace's automated security scan. It has 5 high or critical findings to review. It's listed, but review the security report on this page before installing.

What credentials does Frappe need?

Frappe requires the following credentials or environment variables: FRAPPE_URL, FRAPPE_API_KEY, FRAPPE_API_SECRET, FRAPPE_VERIFY_SSL, FRAPPE_TIMEOUT. You can find setup instructions on the server detail page.

What AI apps work with Frappe ?

Frappe uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Frappe MCP Server

by Muthanii

Developer ToolsModerate5.2MCP RegistryLocal

Free

Server data from the Official MCP Registry

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

About

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

Security Report

5.2

Moderate5.2Moderate Risk

This is a well-structured MCP server for Frappe Framework with proper authentication, good input validation, and appropriate error handling. The codebase demonstrates security awareness through URL encoding to prevent path traversal, context-managed HTTP clients, and secure credential handling via environment variables. Minor code quality observations exist around broad exception handling and logging practices, but these do not materially impact security. Supply chain analysis found 5 known vulnerabilities in dependencies (0 critical, 5 high severity). Package verification found 1 issue.

7 files analyzed · 11 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Base URL of your Frappe/ERPNext site, e.g. https://your-site.erpnext.comOptional

Environment variable: FRAPPE_URL

Frappe API key for token-based authenticationRequired

Environment variable: FRAPPE_API_KEY

Frappe API secret paired with the API keyRequired

Environment variable: FRAPPE_API_SECRET

Set to 'false' to skip TLS certificate verification. Defaults to 'true'.Optional

Environment variable: FRAPPE_VERIFY_SSL

Per-request timeout in seconds. Defaults to 30.Optional

Environment variable: FRAPPE_TIMEOUT

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-muthanii-frappe-mcp": {
      "env": {
        "FRAPPE_URL": "your-frappe-url-here",
        "FRAPPE_API_KEY": "your-frappe-api-key-here",
        "FRAPPE_TIMEOUT": "your-frappe-timeout-here",
        "FRAPPE_API_SECRET": "your-frappe-api-secret-here",
        "FRAPPE_VERIFY_SSL": "your-frappe-verify-ssl-here"
      },
      "args": [
        "frappe-mcp-server"
      ],
      "command": "uvx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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

Distribution	Reference	Page
PyPI	`frappe-mcp-server`	pypi.org/project/frappe-mcp-server
Docker Hub	`muthanii/frappe-mcp`	hub.docker.com/r/muthanii/frappe-mcp
GitHub Container Registry	`ghcr.io/muthanii/frappe-mcp`	ghcr package
MCP Registry	`io.github.muthanii/frappe_mcp`	registry 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

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.

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.

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

Frappe MCP Server

About

Security Report

Findings (11)Action required

Permissions Required

What You'll Need

How to Install

Documentation

Frappe MCP Server

Where to get it

Features

Quick start

Available tools

Configuration

MCP client config

Local development

License

Reviews

No reviews yet

More Developer Tools MCP Servers

Git

Toleno

mcp-creator-python

MarkItDown

MCP Marketplace

FinAgent