Frappe Assistant
Infrastructure that connects LLMs to ERPNext. Frappe Assistant Core works with the Model Context Protocol (MCP) to expose ERPNext functionality to any compatible Language Model
What is Frappe Assistant?
Frappe Assistant is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to infrastructure that connects llms to erpnext. frappe assistant core works with the model context protocol (mcp) to expose erpnext functionality to any compatible language model
Infrastructure that connects LLMs to ERPNext. Frappe Assistant Core works with the Model Context Protocol (MCP) to expose ERPNext functionality to any compatible Language Model
This server falls under the Business Applications category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Infrastructure that connects LLMs to ERPNext. Frappe Assista
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx frappe-assistant-coreConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Frappe Assistant
Frappe Assistant Core is an MCP server that connects any MCP-compatible LLM to an ERPNext or Frappe instance, exposing 24 built-in tools that cover document CRUD, search, reporting, workflow approvals, database queries, and dashboard creation. It uses OAuth 2.0 with PKCE so the LLM never receives user credentials, and all calls are gated by the user's existing Frappe role-based permissions and logged in an audit trail. Business teams use it to query inventory, generate reports, update records, and automate ERP workflows through natural language without writing code.
Prerequisites
- A running ERPNext or Frappe instance (v14+ recommended) accessible over HTTPS
- Frappe bench (for self-hosted) or a Frappe Cloud account
- Claude Desktop, Claude Code, or another MCP-compatible LLM client
- An ERPNext user account with appropriate role permissions for the data you want to access
Install Frappe Assistant Core on your site
For self-hosted Frappe bench installations, fetch and install the app. For Frappe Cloud, navigate to Apps and install from the marketplace.
cd frappe-bench
bench get-app https://github.com/buildswithpaul/Frappe_Assistant_Core
bench --site <your-site> install-app frappe_assistant_coreCopy the MCP Endpoint URL from FAC Admin
In your ERPNext Desk, open FAC Admin and copy the MCP Endpoint URL. This is the URL your MCP client will connect to.
Add the MCP endpoint to Claude Desktop
Open Claude Desktop Settings, go to Connectors, and add a Custom Connector with the MCP Endpoint URL you copied. Authenticate with your ERPNext credentials when prompted.
{
"mcpServers": {
"frappe": {
"url": "https://<your-site>/api/method/frappe_assistant_core.mcp.endpoint"
}
}
}Authorize access via OAuth
After adding the connector, Claude Desktop will redirect you through an OAuth 2.0 PKCE flow. Log in with your ERPNext credentials and grant access. Your LLM session will use your user's role permissions.
Verify the connection
Ask a simple question to confirm the MCP server is connected and returning data from your ERPNext instance.
(Optional) Add custom tools via hooks
External Frappe apps can contribute additional MCP tools by registering them in hooks.py under the assistant_tools or assistant_skills hooks. This allows domain-specific extensions to Frappe Assistant Core.
# In your custom app's hooks.py:
assistant_tools = [
"my_app.tools.custom_tool"
]Frappe Assistant Examples
Client configuration
Claude Desktop configuration pointing to a self-hosted Frappe Assistant Core MCP endpoint. Replace the URL with your actual site URL from FAC Admin.
{
"mcpServers": {
"frappe": {
"url": "https://your-erpnext-site.com/api/method/frappe_assistant_core.mcp.endpoint"
}
}
}Prompts to try
These prompts exercise the document, reporting, and analytics tools exposed by Frappe Assistant Core.
- "Show me overdue invoices from our top five customers"
- "How much stock of SKU-1234 do we have across all warehouses?"
- "Update this lead's status to Qualified and set next action date to Monday"
- "Run the monthly revenue report and summarize the top movers"
- "List all purchase orders submitted in the last 30 days that are pending receipt"Troubleshooting Frappe Assistant
bench get-app fails with permission or network errors
Ensure your bench user has internet access and that the GitHub repository URL is correct. If your server is behind a proxy, configure git's http.proxy setting. For Frappe Cloud, use the in-dashboard marketplace installer instead.
OAuth authentication loop or 'access denied' after login
Verify your ERPNext user has the 'Assistant User' role or equivalent permissions. In FAC Admin, check that the OAuth application is configured and that the redirect URI matches your MCP client's callback URL.
Tool calls return 'Permission denied' for certain documents
Frappe Assistant Core inherits the calling user's role-based permissions. If a tool call is denied, check that your ERPNext user has Read or Write permissions for that DocType in Role Permission Manager.
Frequently Asked Questions about Frappe Assistant
What is Frappe Assistant?
Frappe Assistant is a Model Context Protocol (MCP) server that infrastructure that connects llms to erpnext. frappe assistant core works with the model context protocol (mcp) to expose erpnext functionality to any compatible language model It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Frappe Assistant?
Follow the installation instructions on the Frappe Assistant GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Frappe Assistant?
Frappe Assistant works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Frappe Assistant free to use?
Yes, Frappe Assistant is open source and available under the AGPL-3.0 license. You can use it freely in both personal and commercial projects.
Frappe Assistant Alternatives — Similar Business Applications Servers
Looking for alternatives to Frappe Assistant? Here are other popular business applications servers you can use with Claude, Cursor, and VS Code.
n8n
★ 189.1kA comprehensive MCP server that provides full control over n8n automation workflows through natural language. It offers 43 tools for managing workflows, executions, credentials, and data tables, with safety features like write-mode protection and dou
LobeHub
★ 77.5k🤯 LobeHub is your Chief Agent Operator, organizing your agents into 7×24 operations by hiring, scheduling, and reporting on your entire AI team.
Jeecgboot
★ 46.4kAI 低代码平台，「低代码 + 零代码」双模式驱动：低代码一键生成前后端代码，零代码 5 分钟搭建系统，AI Skills 一句话画流程、设计表单、生成整套系统。内置 AI聊天、知识库、流程编排、MCP插件等，兼容主流大模型。引领「AI 生成 → 在线配置 → 代码生成 → 手工合并->AI修改」开发模式，消除 Java 项目 80% 的重复工作，提效而不失灵活。
CowAgent
★ 44.7kCowAgent (chatgpt-on-wechat) 是基于大模型的超级AI助理，能主动思考和任务规划、访问操作系统和外部资源、创造和执行Skills、通过长期记忆和知识库不断成长，比OpenClaw更轻量和便捷。同时支持微信、飞书、钉钉、企微、QQ、公众号、网页等接入，可选择DeepSeek/OpenAI/Claude/Gemini/ MiniMax/Qwen/GLM/LinkAI，能处理文本、语音、图片和文件，可快速搭建个人AI助理和企业数字员工。
Minds Platform
★ 39.2kPlatform dedicated to building an open foundation for applied Artificial Intelligence, designed for people seeking production-ready AI systems they can truly control, extend and deploy anywhere.
Astrbot
★ 32.8kAI Agent Assistant & development framework that integrates lots of IM platforms, LLMs, plugins and AI feature, and can be your openclaw alternative. ✨
Browse More Business Applications MCP Servers
Explore all business applications servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Frappe Assistant in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Frappe Assistant?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.