sajmustafake avatar

Frappe Dev MCP Server

sajmustafake/frappe-dev-mcp-server

If you're building on Frappe or ERPNext, this server plugs AI assistance directly into your development workflow. It exposes tools for generating DocType JSON definitions and Python controllers, executing bench commands, creating API endpoints, and managing apps and migrations. You can scaffold a complete DocType with fields, links, and validation rules, run migrations against specific sites, or spin up new apps with boilerplate. It connects to your local bench environment via the FRAPPE_PATH variable and works over stdio with Claude Desktop or SSE for GitHub Copilot Chat. Reach for this when you want to skip the manual file editing and bench command syntax lookups that come with standard Frappe development.

GitHub stars
2
tools
7
transport
STDIO
env var
1
last updated
Nov 8, 2025

Tools

7 tools

Public tool metadata for what this MCP can expose to an agent.

frappe_create_doctypeCreates a new Frappe DocType with JSON definition and Python controller.

Creates a new Frappe DocType with JSON definition and Python controller.

No parameter schema in public metadata yet.

frappe_run_bench_commandExecutes bench commands for Frappe development.

Executes bench commands for Frappe development.

No parameter schema in public metadata yet.

frappe_get_app_structureGets the directory structure of a Frappe app.

Gets the directory structure of a Frappe app.

No parameter schema in public metadata yet.

frappe_create_api_endpointCreates a custom API endpoint for a Frappe app.

Creates a custom API endpoint for a Frappe app.

No parameter schema in public metadata yet.

frappe_migrate_databaseRuns database migration for a Frappe site.

Runs database migration for a Frappe site.

No parameter schema in public metadata yet.

frappe_install_appInstalls a Frappe app on a site.

Installs a Frappe app on a site.

No parameter schema in public metadata yet.

frappe_create_appCreates a new Frappe app.

Creates a new Frappe app.

No parameter schema in public metadata yet.

Sponsors

Configuration

FRAPPE_PATH

Path to your Frappe/ERPNext bench directory (defaults to current directory if not specified)

Readme

Frappe/ERPNext MCP Server

A Model Context Protocol (MCP) server that provides AI assistance for Frappe/ERPNext development. This server offers tools to help with creating DocTypes, running bench commands, managing apps, and other Frappe development tasks.

Features

  • DocType Creation: Automatically generate DocType JSON definitions and Python controllers
  • Bench Commands: Execute bench commands for development workflows
  • App Management: Create, install, and manage Frappe apps
  • API Endpoints: Generate custom API endpoints
  • Database Operations: Run migrations and database management
  • App Structure Analysis: Get detailed app directory structures

Installation

  1. Clone or download this repository

  2. Install dependencies:

    npm install
    
  3. Build the server:

    npm run build
    

Configuration

Set the FRAPPE_PATH environment variable to point to your Frappe bench directory:

export FRAPPE_PATH="/path/to/your/frappe/bench"

If not set, it defaults to /Users/mac/ERPNext/mkahawa.

Usage

With GitHub Copilot Chat (SSE Transport)


View the full README on GitHub

Details

Repository
github.com/sajmustafake/frappe-dev-mcp-server
Package
frappe-dev-mcp-server
Transport
STDIO
Registry
MCP registry, active