# Frappe Assistant Core — MCP Bridge for ERPNext > Frappe Assistant Core connects MCP-ready LLMs to ERPNext via OAuth and audit logging (per README). Verified 223★; pushed 2026-05-14. ## Install Merge the JSON below into your `.mcp.json`: ## Quick Use ```bash cd frappe-bench bench get-app https://github.com/buildswithpaul/Frappe_Assistant_Core bench --site install-app frappe_assistant_core # Then connect from your MCP client using the FAC Admin MCP Endpoint URL (per README) ``` ## Intro Frappe Assistant Core connects MCP-ready LLMs to ERPNext via OAuth and audit logging (per README). Verified 223★; pushed 2026-05-14. **Best for:** ERPNext teams who want LLM assistance that stays within real ERP permissions and is auditable **Works with:** ERPNext/Frappe sites; Frappe Cloud marketplace or self-hosted bench; MCP-compatible clients (per README) **Setup time:** 20-60 minutes ### Key facts (verified) - GitHub: 223 stars · 148 forks · pushed 2026-05-14. - License: AGPL-3.0 · owner avatar + repo URL verified via GitHub API. - README-backed entrypoint: `bench --site install-app frappe_assistant_core`. ## Main - Start with a read-only set of ERP use cases (search, list, reports) before enabling update/delete tool calls. - Use OAuth scopes/roles to enforce least privilege: create a dedicated ERP user for the assistant. - Turn on audit log review as a routine: treat tool calls like API access and monitor unexpected queries. - If you extend tools from your own Frappe apps, keep them small and permission-scoped to your DocTypes. ### README (excerpt) **Frappe Assistant Core** > Talk to your ERPNext site. FAC lets Claude, ChatGPT, and other > MCP-ready LLMs work directly with your invoices, customers, stock, > workflows, and custom apps — inside your ERPNext permissions, with > every call logged. [![Version](https://img.shields.io/github/v/release/buildswithpaul/Frappe_Assistant_Core?label=version)](https://github.com/buildswithpaul/Frappe_Assistant_Core/releases) [![Python](https://img.shields.io/badge/python-3.8%2B-blue)](https://pypi.org/project/frappe-assistant-core) [![License](https://img.shields.io/badge/license-AGPL--3.0-green)](LICENSE) [![MCP](https://img.shields.io/badge/MCP-2025--06--18-orange)](https://modelcontextprotocol.io) [![Tools](https://img.shields.io/badge/tools-24-brightgreen)](docs/api/TOOL_REFERENCE.md) [![CI](https://github.com/buildswithpaul/Frappe_Assistant_Core/actions/workflows/ci.yml/badge.svg)](https://github.com/buildswithpaul/Frappe_Assistant_Core/actions/workflows/ci.yml) [![Frappe Cloud](https://img.shields.io/badge/Frappe%20Cloud-Marketplace-blue)](https://cloud.frappe.io/marketplace/apps/frappe_assistant_core) [![Stars](https://img.shields.io/github/stars/buildswithpaul/Frappe_Assistant_Core?style=social)](https://github.com/buildswithpaul/Frappe_Assistant_Core/stargazers) [![Forks](https://img.shields.io/github/forks/buildswithpaul/Frappe_Assistant_Core?style=social)](https://github.com/buildswithpaul/Frappe_Assistant_Core/network/members) [![Sponsors](https://img.shields.io/github/sponsors/buildswithpaul?logo=github)](https://github.com/sponsors/buildswithpaul) --- ## What you get Once FAC is installed, your team can ask an LLM for things they'd normally do by hand: > *"Show me overdue invoices from our top five customers."* > > *"Update this lead's status to Qualified and set next action date to > Monday."* > > *"Run the monthly revenue report and summarise the top movers."* > > *"How much stock of SKU-1234 do we have across all warehouses?"* Behind that simple interaction, FAC exposes **24 built-in tools** for the things your team does every day — document CRUD, search, reports, workflows, analytics, file extraction, and dashboards. Admins can publish **Skills** (reusable instructions that teach the LLM how to ### Source-backed notes - README describes connecting MCP-ready clients to an ERPNext site and authenticating via OAuth 2.0 (PKCE). - README lists a self-hosted install path via `bench get-app ...` and `bench --site install-app ...`. - README states FAC ships 24 built-in tools across plugins (documents, search, reports, analytics, dashboards). ### FAQ - **Does it work with self-hosted ERPNext?**: Yes—README includes a bench-based install path for self-hosted deployments. - **How is access controlled?**: README describes OAuth-based user authentication and ERP role-based permissions. - **How do I keep it safe?**: Start read-only, use a dedicated user, and review audit logs regularly. ## Source & Thanks > Created by [buildswithpaul](https://github.com/buildswithpaul). Licensed under AGPL-3.0. > > [buildswithpaul/Frappe_Assistant_Core](https://github.com/buildswithpaul/Frappe_Assistant_Core) — ⭐ 223 Thanks to the upstream maintainers and contributors for publishing this work under an open license. --- ## Quick Use ```bash cd frappe-bench bench get-app https://github.com/buildswithpaul/Frappe_Assistant_Core bench --site install-app frappe_assistant_core # Then connect from your MCP client using the FAC Admin MCP Endpoint URL (per README) ``` ## Intro Frappe Assistant Core 把 MCP-ready LLM 接入 ERPNext：OAuth 登录、审计日志，并内置 24 个工具（见 README）；已验证 223★，更新于 2026-05-14。 **Best for:** 希望 LLM 在真实 ERP 权限范围内工作，并且可审计可追踪的 ERPNext 团队 **Works with:** ERPNext/Frappe 站点；Frappe Cloud 或自托管 bench；兼容 MCP 的客户端（见 README） **Setup time:** 20-60 minutes ### Key facts (verified) - GitHub：223 stars · 148 forks；最近更新 2026-05-14。 - 许可证：AGPL-3.0；作者头像与仓库链接均已通过 GitHub API 复核。 - README 中可对照的入口：`bench --site install-app frappe_assistant_core`。 ## Main - 先从只读场景落地（检索、列表、报表），确认安全后再逐步开放更新/删除类能力。 - 用 OAuth + 角色体系做最小权限：给助手单独建 ERP 用户并严格分配角色。 - 把审计日志 review 变成例行工作：把工具调用当作 API 访问来监控异常查询。 - 需要扩展自定义工具时，把逻辑做小做窄，并在 DocType 层面做好权限边界。 ### README (excerpt) **Frappe Assistant Core** > Talk to your ERPNext site. FAC lets Claude, ChatGPT, and other > MCP-ready LLMs work directly with your invoices, customers, stock, > workflows, and custom apps — inside your ERPNext permissions, with > every call logged. [![Version](https://img.shields.io/github/v/release/buildswithpaul/Frappe_Assistant_Core?label=version)](https://github.com/buildswithpaul/Frappe_Assistant_Core/releases) [![Python](https://img.shields.io/badge/python-3.8%2B-blue)](https://pypi.org/project/frappe-assistant-core) [![License](https://img.shields.io/badge/license-AGPL--3.0-green)](LICENSE) [![MCP](https://img.shields.io/badge/MCP-2025--06--18-orange)](https://modelcontextprotocol.io) [![Tools](https://img.shields.io/badge/tools-24-brightgreen)](docs/api/TOOL_REFERENCE.md) [![CI](https://github.com/buildswithpaul/Frappe_Assistant_Core/actions/workflows/ci.yml/badge.svg)](https://github.com/buildswithpaul/Frappe_Assistant_Core/actions/workflows/ci.yml) [![Frappe Cloud](https://img.shields.io/badge/Frappe%20Cloud-Marketplace-blue)](https://cloud.frappe.io/marketplace/apps/frappe_assistant_core) [![Stars](https://img.shields.io/github/stars/buildswithpaul/Frappe_Assistant_Core?style=social)](https://github.com/buildswithpaul/Frappe_Assistant_Core/stargazers) [![Forks](https://img.shields.io/github/forks/buildswithpaul/Frappe_Assistant_Core?style=social)](https://github.com/buildswithpaul/Frappe_Assistant_Core/network/members) [![Sponsors](https://img.shields.io/github/sponsors/buildswithpaul?logo=github)](https://github.com/sponsors/buildswithpaul) --- ## What you get Once FAC is installed, your team can ask an LLM for things they'd normally do by hand: > *"Show me overdue invoices from our top five customers."* > > *"Update this lead's status to Qualified and set next action date to > Monday."* > > *"Run the monthly revenue report and summarise the top movers."* > > *"How much stock of SKU-1234 do we have across all warehouses?"* Behind that simple interaction, FAC exposes **24 built-in tools** for the things your team does every day — document CRUD, search, reports, workflows, analytics, file extraction, and dashboards. Admins can publish **Skills** (reusable instructions that teach the LLM how to ### Source-backed notes - README 描述 MCP 客户端通过 OAuth 2.0（PKCE）连接到 ERPNext 站点。 - README 给出自托管安装方式：`bench get-app ...` + `bench --site ... install-app ...`。 - README 提到 FAC 内置 24 个工具，覆盖文档操作、检索、报表、分析与仪表盘等能力。 ### FAQ - **支持自托管 ERPNext 吗？**：支持：README 提供基于 bench 的自托管安装流程。 - **访问权限怎么控制？**：README 描述 OAuth 登录与 ERP 角色权限体系，工具调用在用户权限内执行。 - **如何更安全？**：从只读开始，使用专用用户，并定期审计工具调用日志。 ## Source & Thanks > Created by [buildswithpaul](https://github.com/buildswithpaul). Licensed under AGPL-3.0. > > [buildswithpaul/Frappe_Assistant_Core](https://github.com/buildswithpaul/Frappe_Assistant_Core) — ⭐ 223 --- Source: https://tokrepo.com/en/workflows/frappe-assistant-core-mcp-bridge-for-erpnext Author: MCP Hub