Install
$ agentstack add mcp-vyogotech-frappe-ai ✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
Verified badge
Passed review? Show it. Paste this badge into your README, it links to the public security report.
Reliability & compatibility
Declared compatibility
Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.
We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.
How agent discovery & health will work →About
Frappe AI
[](https://github.com/vyogotech/frappe_ai/actions/workflows/ci.yml)
An in-desk AI assistant for Frappe/ERPNext. Streams responses from a configured AI agent over HTTP and renders markdown prose plus structured KPI / chart / table blocks in a chat sidebar.
Features
- Chat sidebar embedded in the Frappe desk, toggled from the navbar or a custom keyboard shortcut
- Streamed responses relayed through
frappe.realtime(no separate SSE proxy in the browser) - Per-user conversation history persisted as
AI Chat Session/AI Chat Messagedoctypes - Page-context forwarding: the agent sees the user's current route / doctype / docname for grounded answers
- Authentication via the user's existing
sidcookie — no extra OAuth client to provision
Installation
bench get-app https://github.com/vyogotech/frappe_ai
bench --site your-site install-app frappe_ai
bench restart
Then set the agent URL in sites/your-site/site_config.json:
{
"frappe_ai_agent_url": "http://localhost:8484"
}
And open /app/ai-assistant-settings to toggle Enabled.
See [QUICKSTART.md](QUICKSTART.md) for a 5-minute walkthrough or [INSTALLATION.md](INSTALLATION.md) for the full guide.
Usage
Click the AI button in the navbar (or press your configured shortcut) and type a query. Examples:
- "Show me all open projects"
- "What are the top customers by revenue?"
- "List pending sales orders"
Configuration
| Where | Key | Purpose | | --- | --- | --- | | site_config.json | frappe_ai_agent_url | Agent endpoint (authoritative) | | AI Assistant Settings | enabled | Master switch | | AI Assistant Settings | timeout | Per-request timeout (1–300s) | | AI Assistant Settings | sidebar_width | Sidebar width in px (300–600) | | AI Assistant Settings | keyboard_shortcut | Toggle combo (e.g. Alt+/) |
License
MIT
Source & license
This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: vyogotech
- Source: vyogotech/frappe_ai
- License: MIT
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet, be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.