Frappe MCP Server

Frappe MCP Server (Python + uv + Docker)

A modern, containerized Python implementation of the Model Context Protocol (MCP) server for Frappe Framework, built with FastMCP, uv for dependency management, and Docker for deployment.

Features

Document Operations: Full CRUD operations for Frappe documents
Schema Introspection: DocType field definitions and structure analysis
Report Generation: Query reports, financial statements, and data exports
Method Calling: Execute whitelisted Frappe methods
Authentication: Secure API key/secret authentication

Quick Start

Prerequisites

Docker and Docker Compose
Access to a Frappe site with API credentials

Setup

git clone https://github.com/appliedrelevance/frappe_mcp_server_uv.git
cd frappe_mcp_server_uv
cp .env.example .env
# Edit .env with your Frappe credentials
docker-compose up -d frappe-mcp-server

Available MCP Tools

Document Operations

create_document: Create new Frappe documents
get_document: Retrieve document by DocType and name
update_document: Update existing documents
delete_document: Delete documents
list_documents: Query documents with filters
call_method: Execute whitelisted Frappe methods

Schema Operations

get_doctype_schema: Get complete DocType structure
get_field_options: Get Link/Select field options
get_doctype_list: List available DocTypes
get_frappe_usage_info: Combined schema and usage information

Report Operations

run_query_report: Execute Frappe query reports
get_report_meta: Get report metadata and structure
list_reports: List available reports
run_doctype_report: Generate DocType-based reports
get_financial_statements: Access P&L, Balance Sheet, Cash Flow

Helper Operations

ping: Server health check
version: Get server version information
validate_auth: Check API credential status

Development

# Install with development dependencies
uv sync --dev

# Run tests
uv run pytest

# Format code
uv run black src/ && uv run isort src/

License

ISC License - see LICENSE file for details.

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Enables interaction with Frappe Framework sites through comprehensive document operations, schema introspection, report generation, and method execution. Provides secure API-based access to create, read, update, and delete Frappe documents while supporting financial reporting and DocType management.

Related MCP Servers

Alpaca MCP Server
jwaresolutions
-
security
A
license
-
quality
Provides tools for interacting with the Alpaca Trading API, enabling trading operations like getting account information, placing/canceling orders, listing positions, and accessing market data.
Last updated -
MIT License
freee会計 MCP Server
tsurutan
-
security
A
license
-
quality
Enables AI assistants to access and manage accounting data through the freee accounting API, supporting operations like transaction management, financial analysis, and account item management.
Last updated -
598
1
MIT License
Tiptap Collaboration MCP Server
trainual
A
security
A
license
A
quality
Enables interaction with Tiptap collaborative document services through comprehensive document management, real-time statistics, markdown conversion, and batch operations. Supports creating, updating, searching, and managing collaborative documents with health monitoring and semantic search capabilities.
Last updated -
14
5
MIT License
AFFiNE MCP Server
DAWNCR0W
-
security
A
license
-
quality
Enables interaction with AFFiNE workspaces through GraphQL API to manage documents, search content, handle comments, and access version history. Supports comprehensive workspace operations including document publishing, comment management, and user authentication via session cookies or personal access tokens.
Last updated -
36
2
MIT License

View all related MCP servers

Frappe MCP Server