# Foxmayn Frappe CLI

Connects Claude Code to Frappe and ERPNext sites through an MCP server and CLI. Use it to inspect records, reports and workflows, with controlled write access.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 16
- Author: nasroykh
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/nasroykh/foxmayn_frappe_cli
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/foxmayn-frappe-cli

## What it does

Foxmayn Frappe CLI connects Frappe and ERPNext sites to AI clients through the REST API. Its MCP layer exposes work with documents, reports, workflows, files and permissions, while the command line can emit JSON, NDJSON or CSV for scripts.

Set up a site with `ffc init`, using browser sign-in, an API key or a password. Then run `ffc mcp install --client claude-code` to add the connection to Claude Code. Site policies can narrow access to selected DocTypes and server methods; write commands also support confirmations and dry runs.

The client can be forced into read-only mode with `--read-only`. Tool calls are written to a local audit log, and deletes, cancellations, workflow actions and shares require approval. Without a completed `ffc init` login, the server cannot act on a site.

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- inspect Frappe DocType records
- export a report as JSON or CSV
- locate open ERPNext tasks
- check the account’s roles and permissions
- apply a change after approval

## Example prompts
- List open records from the `ToDo` DocType on the connected site.
- Find `Sales Invoice` `ACC-SINV-2026-00001` and show its fields.
- Review the reports and workflows available to my account.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [Front-End Checklist](https://affpapa.org/en/nevibecode/mcp/front-end-checklist.md) — MCP server · ★ 74559
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md