Frappe MCP Server

Enhanced Model Context Protocol server for Frappe Framework with comprehensive API instructions and helper tools

Local serverstdioGo

What is the Frappe MCP Server?

Enhanced Model Context Protocol server for Frappe Framework with comprehensive API instructions and helper tools

What the server does

A Model Context Protocol (MCP) server for Frappe Framework that exposes Frappe's functionality to AI assistants through the official REST API, with a focus on document CRUD operations, schema handling, and detailed API instructions.

This MCP server allows AI assistants to interact with Frappe applications through a standardized interface using the official Frappe REST API. It provides tools for:

Credentials and setup notes

  • Node.js 18 or higher - A running Frappe instance (version 15 or higher) - API key and secret from Frappe (required)

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
find_doctypesFind DocTypes in the system matching a search term
get_module_listGet a list of all modules in the system
get_doctypes_in_moduleGet a list of DocTypes in a specific module
check_doctype_existsCheck if a DocType exists in the system
check_document_existsCheck if a document exists
get_document_countGet a count of documents matching filters
get_naming_infoGet the naming series information for a DocType
get_required_fieldsGet a list of required fields for a DocType
get_api_instructionsGet detailed instructions for using the Frappe API

How to install the Frappe MCP Server

claude mcp add frappe --env FRAPPE_URL=your-value --env FRAPPE_API_KEY=your-value --env FRAPPE_API_SECRET=your-value -- npx -y frappe-mcp-server

Configuration

  • Node.js 18 or higher - A running Frappe instance (version 15 or higher) - API key and secret from Frappe (required)
VariableDescriptionRequired
FRAPPE_URLEndpoint or connection string the server talks to.Yes
FRAPPE_API_KEYCredential the server authenticates with.Yes
FRAPPE_API_SECRETCredential the server authenticates with.Yes

Example prompts to try

  • “Use Frappe to find doctypes.”
  • “Use Frappe to get module list.”
  • “Use Frappe to get doctypes in module.”

Frequently asked questions

Enhanced Model Context Protocol server for Frappe Framework with comprehensive API instructions and helper tools Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.