Skip to main content
Glama
Enterich

Enterich

by Interlusion

An MCP server for ERPNext with hard limits: a short, fixed list of tools, tokens from an external OAuth authorization server, and only the rights of one ERPNext user.

Status: Every operation is tested against a model of ERPNext v16's API, and weekly against a real ERPNext v16 site. The changelog lists the releases.

What it is

  • A separate service, not a Frappe app. It calls ERPNext's REST API with the API key of a dedicated agent user and holds no other ERPNext credential. Whatever the service does, ERPNext's role for that user is the upper limit.

  • A resource server for the MCP authorization spec. It serves the protected resource metadata, answers a missing token with 401, and checks every access token itself (issuer, audience, client, subject). Sign-in happens at an external authorization server such as Keycloak.

  • A fixed list of operations, each with its own purpose and input schema, read and write separated. No generic document access, method calls or file access.

  • Client-neutral. It speaks plain MCP (Streamable HTTP) and doesn't rely on any client asking before a write.

Related MCP server: EasyTouch MCP

What it is not

  • Not a general ERPNext API bridge: tools that take a DocType, report name, method name, field list, filter expression or file path as input are out of scope.

  • Not a way to post: no tool submits, cancels, amends, deletes or discards a document. The agent prepares drafts; a person reviews and submits them in ERPNext (reviewing drafts).

  • Not affiliated with or endorsed by Frappe Technologies. ERPNext and Frappe are their trademarks.

Tools

Enterich offers 37 tools. A deployment may offer fewer (ENTERICH_TOOLS); every tool works on one company, within the rights ERPNext gives the agent user.

Master data (REQ-003)

Items.

Tool

Title

Kind

list_items

List items

read

get_item

Get item

read

Order to cash (REQ-004)

Customers, sales invoices, receivables.

Tool

Title

Kind

list_customers

List customers

read

get_customer

Get customer

read

list_sales_invoices

List sales invoices

read

get_sales_invoice

Get sales invoice

read

list_sales_tax_templates

List sales tax templates

read

report_accounts_receivable

Accounts receivable

read

create_draft_sales_invoice

Create draft sales invoice

create draft

update_draft_sales_invoice

Update draft sales invoice

update draft

create_draft_sales_return

Create draft sales return

create draft

update_draft_sales_return

Update draft sales return

update draft

Procure to pay (REQ-005)

Suppliers, purchase invoices, payables.

Tool

Title

Kind

list_suppliers

List suppliers

read

get_supplier

Get supplier

read

list_purchase_invoices

List purchase invoices

read

get_purchase_invoice

Get purchase invoice

read

list_purchase_tax_templates

List purchase tax templates

read

report_accounts_payable

Accounts payable

read

create_draft_purchase_invoice

Create draft purchase invoice

create draft

update_draft_purchase_invoice

Update draft purchase invoice

update draft

create_draft_purchase_return

Create draft purchase return

create draft

update_draft_purchase_return

Update draft purchase return

update draft

Record to report (REQ-006)

Accounts, cost centres, journal entries, ledger, trial balance.

Tool

Title

Kind

list_accounts

List accounts

read

list_cost_centers

List cost centres

read

list_journal_entries

List journal entries

read

get_journal_entry

Get journal entry

read

report_general_ledger

General ledger

read

report_trial_balance

Trial balance

read

create_draft_journal_entry

Create draft journal entry

create draft

update_draft_journal_entry

Update draft journal entry

update draft

Bank and cash (REQ-007)

Bank accounts, bank transactions, payments.

Tool

Title

Kind

list_bank_accounts

List bank accounts

read

list_bank_transactions

List bank transactions

read

get_bank_transaction

Get bank transaction

read

list_payment_entries

List payment entries

read

get_payment_entry

Get payment entry

read

create_draft_payment_entry

Create draft payment entry

create draft

update_draft_payment_entry

Update draft payment entry

update draft

Scope

Enterich is maintained for our own use. Contributions are welcome (contributing); support isn't promised. Report vulnerabilities privately, as the security policy describes.

Documentation

Start at docs/README.md. The most important parts:

Licence

Apache-2.0. Why: ADR-006.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      A governed MCP server for ERPNext that provides AI agents with access to 51 doctypes and 265 tools through a PLAN-CONSENT-EXECUTE-PROVE workflow, deny-by-default.
      7
      Apache 2.0
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP-compatible AI clients to securely read data from customers' ERPNext/Frappe sites through a multi-tenant OAuth-protected gateway, with tools for listing, searching, counting, retrieving, and reporting on documents.
      -
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI assistants and automation tools to securely query ERPNext data through 16 read-only tools, with OAuth 2.0 or API-key authentication and usage telemetry.
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables Claude clients to connect to an ERPNext site as a remote MCP server with OAuth sign-in, exposing tools to discover DocTypes, read and write documents, run reports, and call whitelisted methods under the signed-in user's permissions.
      -