< Back to all integrations

ERPNext

ERP & Finance

Connect AI agents and workflows to ERPNext: customers, items, sales and purchase orders, invoices, stock and any DocType, with webhooks.

Book a demo
[ ERPNext + engini ]

ERPNext for AI agents and workflows.

engini lets your AI agents and workflows work in ERPNext, the open-source ERP built on Frappe: read and write any DocType, from customers and items to sales orders, invoices and stock entries, submit and cancel documents, run reports, call server methods, and start a workflow the moment an ERPNext webhook fires. Frappe Cloud or your own server. Connect from Claude, ChatGPT or Cursor over MCP, from your code, or build in Workflow Studio.

MCPPython and TypeScript SDKCLIREST APIWorkflow Studio
Sign-inAn ERPNext API key and secret for a user
ReachEvery DocType: customers, items, sales and purchase orders, invoices, stock, accounting, HR and custom DocTypes
TriggersERPNext webhooks on any DocType event
[ 01 / What agents can do ]

What your agent can do in ERPNext. Every tool is one you allow or leave out.

The ERPNext tools in engini, grouped by what they change. Read tools are safe to hand out widely. Write and delete tools go only to the agents that need them.

Read

Get Documents, Get Document

Read any DocType with filters and the fields you choose.

Read
Get Customers, Get Items, Get Stock Balance

Read master data and stock by warehouse.

Read
Get Sales Invoices, Get Purchase Invoices

Read billing and payables.

Read
Run Report

Run a query or script report.

Read

Write

Create Document, Update Document

Write to any DocType you allow.

Write
Submit Document, Cancel Document

Move a document through its workflow, such as submitting a sales invoice.

Write
Call Method

Run a whitelisted server method.

Write

Delete

Delete Document

Remove a draft document.

Delete

Triggers

Document Event

An ERPNext webhook fires when a document is created, updated, submitted or cancelled.

Event
Check for New or Changed Documents

Documents of a DocType changed since the last check.

Scheduled

A trigger starts a workflow, and a workflow can include an AI agent step. In Code, a trigger delivers the event to your own endpoint.

[ 02 / Connect your agent ]

Connect your AI agent to ERPNext. Four ways in, one set of permissions.

MCP

Claude, ChatGPT, Cursor

Create an MCP server in engini with your ERPNext connection and only the tools you choose. Add its address to your client and sign in through engini. There is no key to copy.

MCP client setup →
SDK

Python and TypeScript

Hand your agent a toolset of ERPNext tools. The SDK gives OpenAI and Anthropic models the tools in the format they expect and runs the ones they pick.

SDK guide →
CLI

For coding agents

The engini CLI connects ERPNext and runs its tools from a terminal, with machine-readable output, so an AI coding agent can drive it without getting stuck.

CLI guide →
REST API

Any language

Every ERPNext tool is an endpoint. Call it with exact inputs from a scheduled job or a sync, with no model in the loop.

API reference →
MCP in four steps
In engini, connect ERPNext and create an MCP server with that connection and the tools this agent may use.
Claude: Settings, Connectors, Add custom connector, then paste the server address.
Cursor: add the address to .cursor/mcp.json. Claude Code: claude mcp add.
Sign in through engini when the client asks. The agent sees only the tools you chose.
Cursor, connected to ERPNext through engini
// .cursor/mcp.json: Cursor, connected to ERPNext through engini
{
"mcpServers": {
"engini-erpnext": {
"url": "<your engini MCP server address>"
}
}
}

Create the MCP server in engini with your ERPNext connection and the tools this agent may use, then paste its address. The client signs in through engini on first use. Claude, VS Code and other clients take the same address: see the MCP client setup guide.

Try asking your agent
“Which sales invoices are overdue?”
“Create a sales order for Acme for 25 units of item ITEM-0012 and submit it.”
“How much of ITEM-0012 is in Stores - AC?”
“Run the Accounts Receivable report.”
“Which purchase orders are not received?”
“Add this supplier from the email.”

Each request runs through the ERPNext tools in the agent's toolset or MCP server. If a tool is not allowed, the agent cannot call it.

[ 03 / What teams build ]

What teams build on ERPNext. Agents and workflows, across systems.

Order to cash

Store and CRM orders into ERPNext

Orders from Shopify or HubSpot become ERPNext sales orders, submitted, with stock reserved.

ShopifyHubSpotERPNext
Finance

Payments matched

Stripe payments are recorded as ERPNext payment entries against the right invoice.

StripeERPNext
Operations

Events that act

When a delivery note is submitted, the customer gets tracking and the account owner hears in Slack.

ERPNextSlackGmail
Everyone

Answers from the ERP

An agent answers stock, order and invoice questions. Its toolset holds read tools only.

ClaudeERPNext

Every integration runs both ways, so any of these flows can also run in reverse. These are examples, not the limit: any flow between ERPNext and another system engini connects is available.

[ 04 / Agent Policy ]

You decide what each agent may do in ERPNext. engini enforces it on every call.

Toolsets

Only the tools you allow

A toolset lists the ERPNext tools an agent may call and the connection each one uses. Give one agent read tools only and another the write it needs. engini refuses any call outside the toolset.

MCP servers

Scoped when you set them up

An MCP server exposes only the connections and tools chosen when it is created, and engini shows who uses each server.

Identity

Whose permissions apply

Connect a person's own ERPNext account and engini acts as that person, with their ERPNext permissions. Use a shared integration account and it acts as that account. Every run is recorded under the user who started it.

Credentials

Kept out of prompts

Your agent never needs your credentials: engini stores them and adds them when it runs each call, so keys stay out of prompts and tool inputs.

Audit

Every call on record

Every call lands in History and the audit log, which you can export or stream to your SIEM.

Environments

Test before production

Workspaces keep teams apart, and development, staging and production environments keep a test agent away from live data.

SOC 2 Type IIISO 27001GDPRSecurity at engini →
[ 05 / Set up ]

Connect ERPNext in three steps. Then decide what each agent may do.

Step 01

Sign in to ERPNext

In ERPNext, generate an API key and secret for a user with only the roles the workflows need, then add an ERPNext connection with your site URL, key and secret.

Step 02

Choose the tools

Add the connection to an MCP server or a toolset with only the tools each agent needs.

Step 03

Build or ask

Use the connection as a step in a workflow, or ask your agent to work in ERPNext from Claude, ChatGPT, Cursor or your own code.

[ 06 / Questions ]

ERPNext and engini. Straight answers.

Can an AI agent write to ERPNext, or only read?

Both. engini has tools to create, update, submit, cancel and delete documents of any DocType you allow and to call whitelisted methods. Whether a given agent may use them is up to you: give it a toolset or an MCP server with read tools only, and it cannot call the rest.

Does it work with custom DocTypes and apps?

Yes. Get Documents, Create Document and Call Method work on any DocType and whitelisted method, custom apps included.

Frappe Cloud or self-hosted?

Both. engini connects to the site URL you give it, and to a self-hosted server inside your network through the On-Prem Agent.

Does the agent act as me in ERPNext?

It acts as the ERPNext user whose API key the connection uses, with that user's roles and permissions. Every run is recorded under the person who started it.

Can a change in ERPNext start work?

Yes. An ERPNext webhook can send any document event to engini, and scheduled triggers check any DocType for changes. A workflow can include an AI agent step.