← All integrations

ERPNext MCP server

51 operations0 webhooks

Open-source ERP integration for documents, DocTypes, workflows, stock, selling, buying, and accounting over the Frappe REST API.

Try ERPNext with your agent

Connect ERPNext, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.

Using Corsair, show me what you can do in ERPNext on my account, then run one read-only example and show me the result.

Runs once, when you ask

ERPNext tools and triggers

Tools are what your agent can do in ERPNext through Corsair's MCP server. Triggers are the ERPNext events a routine can start from.

Documents

  • CancelDestructive

    Cancel a submitted document by doctype and name through the frappe.client RPC

    documents.cancel

  • CreateWrite

    Create a document of any DocType from its field values; the response carries the created document

    documents.create

  • DeleteDestructive

    Delete a document of a DocType by its name

    documents.delete

  • GetRead-only

    Read one document of a DocType by its name

    documents.get

  • Get ClientRead-only

    Read a single document through the frappe.client RPC by doctype and name

    documents.getClient

  • Get CountRead-only

    Count the documents of a DocType matching optional filters

    documents.getCount

  • Get ListRead-only

    Query documents through the frappe.client RPC with filtering, field selection, and pagination

    documents.getList

  • Get ValueRead-only

    Read specific field values from documents matching filters without loading the whole document

    documents.getValue

  • Get With MetaRead-only

    Read a document with its desk metadata: attachments, comments, activity logs, and related information

    documents.getWithMeta

  • InsertWrite

    Insert a document through the frappe.client RPC, passing the full document object including its doctype field

    documents.insert

  • Insert ManyWrite

    Insert multiple documents in one call for efficiency; each item carries its doctype and field values

    documents.insertMany

  • ListRead-only

    List documents of a DocType with field selection, filters, ordering, and pagination

    documents.list

Connect ERPNext to Claude, ChatGPT or Cursor

  1. 1

    Connect ERPNext in Corsair

    Add your ERPNext API key once in Corsair. Corsair stores the credential encrypted and makes the ERPNext API calls for your agent, so it never goes into a prompt or a config file. Connect ERPNext

    If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs ERPNext. On a ChatGPT personal plan, connect ERPNext here first.

  2. 2

    Add Corsair's MCP server to your agent

    Every client uses the same address:

    https://mcp.corsair.dev/mcp
    Open Customize → Connectors → Add custom connector, paste the address, then select Connect.

    Codex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client

  3. 3

    Sign in and choose what needs your approval

    Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. In the default Cautious mode, ERPNext's read and write operations run right away and its 7 destructive operations wait for your approval. Strict mode asks before every write and refuses destructive operations, and Read mode allows reads only.

FAQ

Install corsair and @corsair-dev/erpnext, add the ERPNext plugin, and connect with an API key. Then call methods like corsair.erpnext.api.desk.addComment() from your app. Corsair syncs data per tenant.

Yes. ERPNext requires an API key from your ERPNext account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.

Yes. One Corsair client can hit ERPNext, GitHub, Notion, Stripe, and the rest. Trigger ERPNext from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.

Teams use Corsair for open-source ERP integration for documents, DocTypes, workflows, stock, selling, buying, and accounting over the Frappe REST API. Common builds include sync jobs, admin tooling, and agents that call ERPNext APIs from your backend. Local DB entities let you query synced ERPNext records without hitting the API on every read.

The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per ERPNext API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.

We maintain @corsair-dev/erpnext in the open repo. When ERPNext ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.

No. Corsair does not read your ERPNext data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store ERPNext data on your behalf.

Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.

Yes. Put ERPNext on a link in Strict mode and every write waits for your approval, while destructive actions are refused. The default Cautious mode asks only before the 7 destructive ERPNext operations. You can change a link's mode at hub.corsair.dev/me.