# Frappe Ai

> Frappe Conversational AI interfaces that leverages ERPNext MCP server

- **Type:** MCP server
- **Install:** `agentstack add mcp-vyogotech-frappe-ai`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [vyogotech](https://agentstack.voostack.com/s/vyogotech)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [vyogotech](https://github.com/vyogotech)
- **Source:** https://github.com/vyogotech/frappe_ai

## Install

```sh
agentstack add mcp-vyogotech-frappe-ai
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## 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 Message` doctypes
- Page-context forwarding: the agent sees the user's current route / doctype / docname for grounded answers
- Authentication via the user's existing `sid` cookie — no extra OAuth client to provision

## Installation

```bash
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`:

```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](https://github.com/vyogotech)
- **Source:** [vyogotech/frappe_ai](https://github.com/vyogotech/frappe_ai)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-vyogotech-frappe-ai
- Seller: https://agentstack.voostack.com/s/vyogotech
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.