Skip to content
MCP server

Enterich

ERPNext accounting for AI agents: 37 fixed tools that read data and only create drafts

Install
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.0

Add 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 servedRequired
  • ENTERICH_ISSUERThe authorization server's issuer, httpsRequired
  • ENTERICH_JWKS_URLThe authorization server's signing keys, httpsRequired
  • ENTERICH_CLIENT_IDThe OAuth client the agent's tokens are issued toRequired
  • ENTERICH_SUBJECTThe agent identity's subRequired
  • ENTERICH_REQUIRED_SCOPESScopes required in the token, space-separated
  • ENTERICH_TOKEN_ALGORITHMSToken signing algorithms accepted, comma-separated
  • ENTERICH_CLOCK_LEEWAYSeconds of clock leeway for token times, 0 to 60
  • ENTERICH_ERPNEXT_URLThe base URL Enterich calls ERPNext atRequired
  • ENTERICH_ERPNEXT_HOSTThe Host header sent to ERPNext, by default the URL's host
  • ENTERICH_ERPNEXT_PUBLIC_URLThe base URL people open ERPNext at, for links in resultsRequired
  • ENTERICH_ERPNEXT_API_KEYThe ERPNext agent user's API keyRequired
  • ENTERICH_ERPNEXT_API_SECRETThe ERPNext agent user's API secretRequired
  • ENTERICH_COMPANYThe assigned company, exactly as named in ERPNextRequired
  • ENTERICH_TOOLSThe operations to offer, comma-separated; by default all
  • ENTERICH_MAX_DRAFTS_PER_HOURMost drafts of each type the agent may create in an hour; unset, no limit
  • ENTERICH_TIMEZONEIANA time zone for today's date, the ERPNext site's
  • ENTERICH_HOSTThe listen address
  • ENTERICH_PORTThe listen port
  • ENTERICH_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.

How AIPoweredBot checks servers