Frappe MCP Server
Interact with Frappe/ERPNext sites — document CRUD, search, and whitelisted method calls
- 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-serverAdd 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.comRequiredFRAPPE_API_KEYFrappe API key for token-based authenticationRequiredFRAPPE_API_SECRETFrappe API secret paired with the API keyRequiredFRAPPE_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.comRequiredFRAPPE_API_KEYFrappe API key for token-based authenticationRequiredFRAPPE_API_SECRETFrappe API secret paired with the API keyRequiredFRAPPE_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.comRequiredFRAPPE_API_KEYFrappe API key for token-based authenticationRequiredFRAPPE_API_SECRETFrappe API secret paired with the API keyRequiredFRAPPE_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.