Frappe MCP Server

io.github.muthaniiPublished by GitHub account muthaniiv1.2.0Updated Oct 27, 2026

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

VerifiedSTDIODesktop onlyDatabases Business & Commerce

Server details

Identifier: io.github.muthanii/frappe_mcp
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account muthanii for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.muthanii%2Ffrappe_mcp.svg)](https://sourceweft.com/mcp/io.github.muthanii%2Ffrappe_mcp?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Connects an assistant to a Frappe/ERPNext site over its REST API for document CRUD, search, and whitelisted server-side method calls.

What you can do: Check connectivity and credentials against the site
Retrieve a single document by doctype and name
Search and list documents with filters
Create, update and delete documents
Call whitelisted server-side Python methods
When to use it: Useful when you work with a Frappe or ERPNext site and want an assistant to look up, edit or create records, or trigger server-side methods, without leaving the chat client.
Requirements: Runs locally as a stdio process via uvx, pip, or Docker. Needs FRAPPE_URL (base URL of the site), FRAPPE_API_KEY and FRAPPE_API_SECRET for token authentication, plus network access to the site. Optional FRAPPE_TIMEOUT (default 30) and FRAPPE_VERIFY_SSL (default true).

Before you install

Requires an API key and secret with the permissions of that user; the assistant can create, update and delete documents, and deletion is irreversible. frappe_run_method can invoke any whitelisted server-side method, so its effect depends entirely on the method named. Setting FRAPPE_VERIFY_SSL to false disables TLS certificate checks.

Installation

In SourceWeft

Open Frappe MCP Server in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Frappe MCP Server

[PyPI] [Python] [Docker Hub] [Docker pulls] [GHCR] [MCP Registry] [License]

[frappe_mcp 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.

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):

bash

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

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

With pip:

With Docker (Docker Hub):

bash

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

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):

bash

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

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.

Tool	Description	Access	Destructive	Idempotent
`frappe_ping`	Check connectivity and credentials	read-only	no	yes
`frappe_get_doc`	Retrieve a single document by doctype + name	read-only	no	yes
`frappe_search_docs`	Search/list documents with filters	read-only	no	yes
`frappe_create_doc`	Create a new document	write	no	no
`frappe_update_doc`	Update an existing document	write	yes	yes
`frappe_delete_doc`	Delete a document — irreversible	write	yes	no
`frappe_run_method`	Call a whitelisted server-side method	write	yes	no

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

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:

json

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

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

json

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

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

License

MIT — see LICENSE.

[frappe_mcp MCP server]

Source: README.md at commit e1f8986

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v1.2.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts