AnythingMCP Cloud is live — 7-day free trial−30% for 3 months with START30
AnythingMCP
Connector guide3-minute read11 MCP tools7 languages

How to Connect ERPNext to Gemini — via MCP

ERPNext / Frappe: read and write any DocType — customers, sales orders, invoices, items, stock and leads — with Frappe's filter syntax, plus a generic resource escape hatch. Token auth against your own instance.

HCBy HelpCode teamUpdated 3 min read Open-source on GitHub
Install ERPNext on Cloud — free trialRead the step-by-step guide

No credit card · 7-day trial · Self-host alternative available

ERPNext

ERPNext

ERPNext / Frappe: read and write any DocType — customers, sales orders, invoices, items, stock and leads — with Frappe's filter syntax, plus a generic resource escape hatch. Token auth against your own instance.

tools

11

Region

INTL

Category

ERP

Authentication

API Key

Required env vars

ERPNEXT_URLERPNEXT_API_KEYERPNEXT_API_SECRET
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Open source · AGPL-3.0
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

Skip the install. Get this working in under 2 minutes.

Start a free trial on cloud.anythingmcp.com, add the ERPNext in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.

Start free trial

Summary

ERPNext / Frappe: read and write any DocType — customers, sales orders, invoices, items, stock and leads — with Frappe's filter syntax, plus a generic resource escape hatch. Token auth against your own instance.

Try asking

Example prompts for ERPNext

Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.

ERPNext · live via MCP
Share
Opus 4.7

Claude is AI and can make mistakes. Please double-check responses.

💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → ERPNext, paste your credentials, mint an MCP API key — done. No Docker, no git clone, no local server.

ERPNext + Gemini

ERPNext / Frappe: read and write any DocType — customers, sales orders, invoices, items, stock and leads — with Frappe's filter syntax, plus a generic resource escape hatch. Token auth against your own instance.

Prerequisites

See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:

ERPNEXT_URL, ERPNEXT_API_KEY, ERPNEXT_API_SECRET

Step 1 — Get credentials

Getting a key

  1. In ERPNext open the user you want the agent to act as → Settings → API Access → Generate Keys. You receive an API key and an API secret; the secret is shown once.
  2. Set ERPNEXT_URL to your instance root (no trailing slash), ERPNEXT_API_KEY and ERPNEXT_API_SECRET.

The Authorization header is token key:secret — lower-case token, the two values joined by a colon. Not Bearer, not Basic. This is the single most common reason a correct ERPNext key 401s.

…(continued in the in-app connector instructions)

Step 2 — Install the adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Add the connector in Gemini

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Gemini CLI reads MCP servers from ~/.gemini/settings.json (or %APPDATA%\gemini\settings.json on Windows). Add:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}
  1. Get your MCP API key from AnythingMCP → MCP Servers → your server → API keys.
  2. Save the file and restart gemini.
  3. Run /mcp inside the Gemini CLI — ERPNext should be listed as available.
  4. Vertex AI Studio: pass https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID to the tools array of your request with the same X-API-Key header.

Available tools

ToolWhat it does
erpnext_get_logged_userRead which user the API key belongs to
erpnext_list_documentsList documents of any DocType with Frappe filters
erpnext_get_documentRead one document of any DocType in full by its name (ERPNext's primary key), including its child tables
erpnext_count_documentsCount the documents of a DocType matching a filter, without transferring them
erpnext_get_doctype_metaDescribe a DocType: every field with its type, label, options and whether it is required
erpnext_list_customersList customers with their name, group, territory, currency and default payment terms
erpnext_list_sales_ordersList sales orders with their customer, date, delivery date, status and grand total
erpnext_list_sales_invoicesList sales invoices with their customer, posting date, due date, status and outstanding amount — the answer to 'what is still unpaid'
erpnext_list_itemsList items from the catalogue with their code, name, group, stock UOM and default rate
erpnext_list_stock_balanceRead per-warehouse stock: actual, reserved and projected quantity per item
erpnext_create_documentCreate a document of any DocType

FAQ

Does Gemini 1.5 Pro or 2.x support MCP? Yes — Gemini CLI ≥ 0.4 and Vertex AI tools API both accept MCP httpUrl connectors with custom headers.

Next steps

Was this guide helpful?

Your ERPNext agent is one click away.

Install the connector, paste the key, prompt Gemini. Free for 7 days, no credit card.

Start free on CloudSelf-host with DockerContact Sales

Related guides

Connectors

How to Connect ERPNext to Meta Muse — via MCP

ERPNext / Frappe: read and write any DocType — customers, sales orders, invoices, items, stock and leads — with Frappe's filter syntax, plus a generic resource escape hatch. Token auth against your own instance.

Connectors

How to Connect ERPNext to ChatGPT — via MCP

ERPNext / Frappe: read and write any DocType — customers, sales orders, invoices, items, stock and leads — with Frappe's filter syntax, plus a generic resource escape hatch. Token auth against your own instance.

Connectors

How to Connect ERPNext to Claude — via MCP

ERPNext / Frappe: read and write any DocType — customers, sales orders, invoices, items, stock and leads — with Frappe's filter syntax, plus a generic resource escape hatch. Token auth against your own instance.

Connectors

How to Connect ERPNext to Cursor — via MCP

ERPNext / Frappe: read and write any DocType — customers, sales orders, invoices, items, stock and leads — with Frappe's filter syntax, plus a generic resource escape hatch. Token auth against your own instance.

Connectors

ERPNext to MCP — Drive ERPNext from any AI Agent

ERPNext / Frappe: read and write any DocType — customers, sales orders, invoices, items, stock and leads — with Frappe's filter syntax, plus a generic resource escape hatch. Token auth against your own instance.

Connectors

How to Connect Affinity to Gemini via MCP

Let your AI work with Affinity, the relationship intelligence CRM: search companies, people and deals, read lists and pipeline fields, notes, e-mail and meeting history, who on your team knows someone best, and reminders; with your confirmation add notes and update field values.