Skip to content

erpnext-agent

ERPNext and Frappe REST/RPC API + MCP Server for the agent-utilities ecosystem — a typed, deterministic tool surface over the ERPNext / Frappe business platform.

Official documentation

This site is the canonical reference for erpnext-agent, maintained alongside every release.

PyPI MCP Server License GitHub

Overview

erpnext-agent wraps the ERPNext / Frappe Framework REST and whitelisted-RPC surface with typed, deterministic MCP tools, and ships an optional Pydantic-AI agent server for conversational workflows. It provides:

  • Api — a tolerant requests-based REST/RPC facade over the Frappe site (token or username/password authentication, configurable TLS verification).
  • Document and method tools — read, create, update, delete, and list any ERPNext DocType, plus call_method to invoke any whitelisted RPC endpoint (covering custom server functions).
  • An MCP server (erpnext-mcp) and a companion agent server (erpnext-agent) that calls those tools through a policy router.

The connector remains inactive when credentials are absent, so it is safe to load in any environment.

Explore the documentation

  • Installation — pip, source, extras, and the prebuilt Docker image.
  • Deployment — run the MCP and agent servers, Docker Compose, Caddy + Technitium.
  • Usage — the MCP tools, the Api client, and example prompts.
  • Backing Platform — deploy ERPNext / Frappe with Docker.
  • Overview — the dynamic facade and FastMCP tool layer.
  • Concepts — the CONCEPT:ERPN-* registry.

Quick start

pip install "erpnext-agent[mcp]"
erpnext-mcp                       # stdio MCP server (default transport)

Connect it to an ERPNext / Frappe site:

export ERPNEXT_URL=https://your-erpnext:8000
export ERPNEXT_TOKEN=your_api_key:your_api_secret
erpnext-mcp --transport streamable-http --host 0.0.0.0 --port 8000

See Installation and Deployment for the full matrix (PyPI extras, Docker image, all transports, reverse proxy, DNS).