Enterich
ERPNext accounting for AI agents: 37 fixed tools that read data and only create drafts
- Pricing
- Open source
- Platforms
- self-hosted, API
- Runs
- Remotely
- Version
- 0.6.0
- Listing updated
- today
Similar MCP servers
About Enterich
Enterich is an open-source MCP server for finance and payments. It runs as a hosted remote server, so there is nothing to install locally.
Enterich is built around limits. It is a separate service, not a Frappe app, that calls ERPNext's REST API with the API key of one dedicated agent user, so whatever that user's ERPNext role forbids, the agent cannot do. Callers authenticate with OAuth tokens from an external authorization server such as Keycloak, and Enterich checks issuer, audience, client and subject on every token itself.
The 37 tools are grouped by accounting area: master data, order to cash, procure to pay, record to report, and bank and cash. Reads cover items, customers, suppliers, invoices, accounts, the general ledger, trial balance, receivables and payables. Writes are limited to creating and updating drafts of invoices, returns, journal entries and payment entries. No tool submits, cancels, amends or deletes, so a person reviews and posts each draft in ERPNext.
It is deliberately not a general API bridge: tools taking a DocType, method name, filter expression or file path are out of scope. Settings let an operator restrict the tool list and cap drafts per hour, and each deployment serves one company. It ships as an OCI image under Apache-2.0, maintained for the authors' own use with no promised support, and is not affiliated with Frappe.
Install
Run in a terminal
claude mcp add enterich --env ENTERICH_RESOURCE_URL='<ENTERICH_RESOURCE_URL>' --env ENTERICH_ISSUER='<ENTERICH_ISSUER>' --env ENTERICH_JWKS_URL='<ENTERICH_JWKS_URL>' --env ENTERICH_CLIENT_ID='<ENTERICH_CLIENT_ID>' --env ENTERICH_SUBJECT='<ENTERICH_SUBJECT>' --env ENTERICH_ERPNEXT_URL='<ENTERICH_ERPNEXT_URL>' --env ENTERICH_ERPNEXT_PUBLIC_URL='<ENTERICH_ERPNEXT_PUBLIC_URL>' --env ENTERICH_ERPNEXT_API_KEY='<ENTERICH_ERPNEXT_API_KEY>' --env ENTERICH_ERPNEXT_API_SECRET='<ENTERICH_ERPNEXT_API_SECRET>' --env ENTERICH_COMPANY='<ENTERICH_COMPANY>' -- docker run -i --rm -e ENTERICH_RESOURCE_URL -e ENTERICH_ISSUER -e ENTERICH_JWKS_URL -e ENTERICH_CLIENT_ID -e ENTERICH_SUBJECT -e ENTERICH_ERPNEXT_URL -e ENTERICH_ERPNEXT_PUBLIC_URL -e ENTERICH_ERPNEXT_API_KEY -e ENTERICH_ERPNEXT_API_SECRET -e ENTERICH_COMPANY ghcr.io/interlusion/enterich:0.6.0Add to claude_desktop_config.json
{
"mcpServers": {
"enterich": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ENTERICH_RESOURCE_URL",
"-e",
"ENTERICH_ISSUER",
"-e",
"ENTERICH_JWKS_URL",
"-e",
"ENTERICH_CLIENT_ID",
"-e",
"ENTERICH_SUBJECT",
"-e",
"ENTERICH_ERPNEXT_URL",
"-e",
"ENTERICH_ERPNEXT_PUBLIC_URL",
"-e",
"ENTERICH_ERPNEXT_API_KEY",
"-e",
"ENTERICH_ERPNEXT_API_SECRET",
"-e",
"ENTERICH_COMPANY",
"ghcr.io/interlusion/enterich:0.6.0"
],
"env": {
"ENTERICH_RESOURCE_URL": "<ENTERICH_RESOURCE_URL>",
"ENTERICH_ISSUER": "<ENTERICH_ISSUER>",
"ENTERICH_JWKS_URL": "<ENTERICH_JWKS_URL>",
"ENTERICH_CLIENT_ID": "<ENTERICH_CLIENT_ID>",
"ENTERICH_SUBJECT": "<ENTERICH_SUBJECT>",
"ENTERICH_ERPNEXT_URL": "<ENTERICH_ERPNEXT_URL>",
"ENTERICH_ERPNEXT_PUBLIC_URL": "<ENTERICH_ERPNEXT_PUBLIC_URL>",
"ENTERICH_ERPNEXT_API_KEY": "<ENTERICH_ERPNEXT_API_KEY>",
"ENTERICH_ERPNEXT_API_SECRET": "<ENTERICH_ERPNEXT_API_SECRET>",
"ENTERICH_COMPANY": "<ENTERICH_COMPANY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"enterich": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ENTERICH_RESOURCE_URL",
"-e",
"ENTERICH_ISSUER",
"-e",
"ENTERICH_JWKS_URL",
"-e",
"ENTERICH_CLIENT_ID",
"-e",
"ENTERICH_SUBJECT",
"-e",
"ENTERICH_ERPNEXT_URL",
"-e",
"ENTERICH_ERPNEXT_PUBLIC_URL",
"-e",
"ENTERICH_ERPNEXT_API_KEY",
"-e",
"ENTERICH_ERPNEXT_API_SECRET",
"-e",
"ENTERICH_COMPANY",
"ghcr.io/interlusion/enterich:0.6.0"
],
"env": {
"ENTERICH_RESOURCE_URL": "<ENTERICH_RESOURCE_URL>",
"ENTERICH_ISSUER": "<ENTERICH_ISSUER>",
"ENTERICH_JWKS_URL": "<ENTERICH_JWKS_URL>",
"ENTERICH_CLIENT_ID": "<ENTERICH_CLIENT_ID>",
"ENTERICH_SUBJECT": "<ENTERICH_SUBJECT>",
"ENTERICH_ERPNEXT_URL": "<ENTERICH_ERPNEXT_URL>",
"ENTERICH_ERPNEXT_PUBLIC_URL": "<ENTERICH_ERPNEXT_PUBLIC_URL>",
"ENTERICH_ERPNEXT_API_KEY": "<ENTERICH_ERPNEXT_API_KEY>",
"ENTERICH_ERPNEXT_API_SECRET": "<ENTERICH_ERPNEXT_API_SECRET>",
"ENTERICH_COMPANY": "<ENTERICH_COMPANY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"enterich": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ENTERICH_RESOURCE_URL",
"-e",
"ENTERICH_ISSUER",
"-e",
"ENTERICH_JWKS_URL",
"-e",
"ENTERICH_CLIENT_ID",
"-e",
"ENTERICH_SUBJECT",
"-e",
"ENTERICH_ERPNEXT_URL",
"-e",
"ENTERICH_ERPNEXT_PUBLIC_URL",
"-e",
"ENTERICH_ERPNEXT_API_KEY",
"-e",
"ENTERICH_ERPNEXT_API_SECRET",
"-e",
"ENTERICH_COMPANY",
"ghcr.io/interlusion/enterich:0.6.0"
],
"env": {
"ENTERICH_RESOURCE_URL": "<ENTERICH_RESOURCE_URL>",
"ENTERICH_ISSUER": "<ENTERICH_ISSUER>",
"ENTERICH_JWKS_URL": "<ENTERICH_JWKS_URL>",
"ENTERICH_CLIENT_ID": "<ENTERICH_CLIENT_ID>",
"ENTERICH_SUBJECT": "<ENTERICH_SUBJECT>",
"ENTERICH_ERPNEXT_URL": "<ENTERICH_ERPNEXT_URL>",
"ENTERICH_ERPNEXT_PUBLIC_URL": "<ENTERICH_ERPNEXT_PUBLIC_URL>",
"ENTERICH_ERPNEXT_API_KEY": "<ENTERICH_ERPNEXT_API_KEY>",
"ENTERICH_ERPNEXT_API_SECRET": "<ENTERICH_ERPNEXT_API_SECRET>",
"ENTERICH_COMPANY": "<ENTERICH_COMPANY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"enterich": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ENTERICH_RESOURCE_URL",
"-e",
"ENTERICH_ISSUER",
"-e",
"ENTERICH_JWKS_URL",
"-e",
"ENTERICH_CLIENT_ID",
"-e",
"ENTERICH_SUBJECT",
"-e",
"ENTERICH_ERPNEXT_URL",
"-e",
"ENTERICH_ERPNEXT_PUBLIC_URL",
"-e",
"ENTERICH_ERPNEXT_API_KEY",
"-e",
"ENTERICH_ERPNEXT_API_SECRET",
"-e",
"ENTERICH_COMPANY",
"ghcr.io/interlusion/enterich:0.6.0"
],
"env": {
"ENTERICH_RESOURCE_URL": "<ENTERICH_RESOURCE_URL>",
"ENTERICH_ISSUER": "<ENTERICH_ISSUER>",
"ENTERICH_JWKS_URL": "<ENTERICH_JWKS_URL>",
"ENTERICH_CLIENT_ID": "<ENTERICH_CLIENT_ID>",
"ENTERICH_SUBJECT": "<ENTERICH_SUBJECT>",
"ENTERICH_ERPNEXT_URL": "<ENTERICH_ERPNEXT_URL>",
"ENTERICH_ERPNEXT_PUBLIC_URL": "<ENTERICH_ERPNEXT_PUBLIC_URL>",
"ENTERICH_ERPNEXT_API_KEY": "<ENTERICH_ERPNEXT_API_KEY>",
"ENTERICH_ERPNEXT_API_SECRET": "<ENTERICH_ERPNEXT_API_SECRET>",
"ENTERICH_COMPANY": "<ENTERICH_COMPANY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"enterich": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ENTERICH_RESOURCE_URL",
"-e",
"ENTERICH_ISSUER",
"-e",
"ENTERICH_JWKS_URL",
"-e",
"ENTERICH_CLIENT_ID",
"-e",
"ENTERICH_SUBJECT",
"-e",
"ENTERICH_ERPNEXT_URL",
"-e",
"ENTERICH_ERPNEXT_PUBLIC_URL",
"-e",
"ENTERICH_ERPNEXT_API_KEY",
"-e",
"ENTERICH_ERPNEXT_API_SECRET",
"-e",
"ENTERICH_COMPANY",
"ghcr.io/interlusion/enterich:0.6.0"
],
"env": {
"ENTERICH_RESOURCE_URL": "<ENTERICH_RESOURCE_URL>",
"ENTERICH_ISSUER": "<ENTERICH_ISSUER>",
"ENTERICH_JWKS_URL": "<ENTERICH_JWKS_URL>",
"ENTERICH_CLIENT_ID": "<ENTERICH_CLIENT_ID>",
"ENTERICH_SUBJECT": "<ENTERICH_SUBJECT>",
"ENTERICH_ERPNEXT_URL": "<ENTERICH_ERPNEXT_URL>",
"ENTERICH_ERPNEXT_PUBLIC_URL": "<ENTERICH_ERPNEXT_PUBLIC_URL>",
"ENTERICH_ERPNEXT_API_KEY": "<ENTERICH_ERPNEXT_API_KEY>",
"ENTERICH_ERPNEXT_API_SECRET": "<ENTERICH_ERPNEXT_API_SECRET>",
"ENTERICH_COMPANY": "<ENTERICH_COMPANY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
ENTERICH_RESOURCE_URLThe MCP endpoint exactly as clients enter it, https; its path is the one servedRequiredENTERICH_ISSUERThe authorization server's issuer, httpsRequiredENTERICH_JWKS_URLThe authorization server's signing keys, httpsRequiredENTERICH_CLIENT_IDThe OAuth client the agent's tokens are issued toRequiredENTERICH_SUBJECTThe agent identity's subRequiredENTERICH_REQUIRED_SCOPESScopes required in the token, space-separatedENTERICH_TOKEN_ALGORITHMSToken signing algorithms accepted, comma-separatedENTERICH_CLOCK_LEEWAYSeconds of clock leeway for token times, 0 to 60ENTERICH_ERPNEXT_URLThe base URL Enterich calls ERPNext atRequiredENTERICH_ERPNEXT_HOSTThe Host header sent to ERPNext, by default the URL's hostENTERICH_ERPNEXT_PUBLIC_URLThe base URL people open ERPNext at, for links in resultsRequiredENTERICH_ERPNEXT_API_KEYThe ERPNext agent user's API keyRequiredENTERICH_ERPNEXT_API_SECRETThe ERPNext agent user's API secretRequiredENTERICH_COMPANYThe assigned company, exactly as named in ERPNextRequiredENTERICH_TOOLSThe operations to offer, comma-separated; by default allENTERICH_MAX_DRAFTS_PER_HOURMost drafts of each type the agent may create in an hour; unset, no limitENTERICH_TIMEZONEIANA time zone for today's date, the ERPNext site'sENTERICH_HOSTThe listen addressENTERICH_PORTThe listen portENTERICH_LOG_LEVELThe level for libraries' log lines: DEBUG, INFO, WARNING or ERROR
Tools this server provides (18)
Taken from the project documentation; the running server may differ.
- list_items
- List items
- get_item
- Get item
- list_customers
- List customers
- get_customer
- Get customer
- list_sales_invoices
- List sales invoices
- get_sales_invoice
- Get sales invoice
- report_accounts_receivable
- Accounts receivable report
- create_draft_sales_invoice
- Create a draft sales invoice
- list_suppliers
- List suppliers
- list_purchase_invoices
- List purchase invoices
- report_accounts_payable
- Accounts payable report
- create_draft_purchase_invoice
- Create a draft purchase invoice
- report_general_ledger
- General ledger report
- report_trial_balance
- Trial balance report
- create_draft_journal_entry
- Create a draft journal entry
- list_bank_transactions
- List bank transactions
- list_payment_entries
- List payment entries
- create_draft_payment_entry
- Create a draft payment entry
What it does
- Fixed tool list
- 37 purpose-built tools with their own schemas, no generic document access.
- Drafts only
- Agents create and update drafts; people submit them in ERPNext.
- One agent user
- ERPNext's role for a single dedicated user is the upper limit.
- OAuth resource server
- Validates issuer, audience, client and subject on each token.
- Single company scope
- Every tool works on one assigned company.
- Operator controls
- Restrict which tools are offered and limit drafts per hour.
Good for
- Have an agent draft sales invoices for review
- Pull a trial balance or general ledger into a chat
- Check accounts receivable and payable
- Prepare draft journal entries for an accountant to post
Pricing
Open source
Free, Apache-2.0; self-hosted
Enterich FAQ
Can the agent post or delete documents?
No. No tool submits, cancels, amends, deletes or discards a document.
How is it deployed?
As an OCI container image, ghcr.io/interlusion/enterich, configured with environment variables.
Which ERPNext version is tested?
The README says operations are tested against a model of v16's API and weekly against a real v16 site.
What licence is it under?
Apache-2.0.
Is Enterich free?
Yes. Enterich is open source, so you can use and self-host it for free.
How do I add Enterich to Claude Code?
Run this command in your terminal: claude mcp add enterich --env ENTERICH_RESOURCE_URL='<ENTERICH_RESOURCE_URL>' --env ENTERICH_ISSUER='<ENTERICH_ISSUER>' --env ENTERICH_JWKS_URL='<ENTERICH_JWKS_URL>' --env ENTERICH_CLIENT_ID='<ENTERICH_CLIENT_ID>' --env ENTERICH_SUBJECT='<ENTERICH_SUBJECT>' --env ENTERICH_ERPNEXT_URL='<ENTERICH_ERPNEXT_URL>' --env ENTERICH_ERPNEXT_PUBLIC_URL='<ENTERICH_ERPNEXT_PUBLIC_URL>' --env ENTERICH_ERPNEXT_API_KEY='<ENTERICH_ERPNEXT_API_KEY>' --env ENTERICH_ERPNEXT_API_SECRET='<ENTERICH_ERPNEXT_API_SECRET>' --env ENTERICH_COMPANY='<ENTERICH_COMPANY>' -- docker run -i --rm -e ENTERICH_RESOURCE_URL -e ENTERICH_ISSUER -e ENTERICH_JWKS_URL -e ENTERICH_CLIENT_ID -e ENTERICH_SUBJECT -e ENTERICH_ERPNEXT_URL -e ENTERICH_ERPNEXT_PUBLIC_URL -e ENTERICH_ERPNEXT_API_KEY -e ENTERICH_ERPNEXT_API_SECRET -e ENTERICH_COMPANY ghcr.io/interlusion/enterich:0.6.0
What are the best alternatives to Enterich?
The closest alternatives to Enterich are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Crypto Feeds and Crypto Fng.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

