Omie

@codespar/mcp-omie · v0.2.2

🇧🇷 BrazilERPAuth · API Keylive30 tools2 env vars

Full ERP: sales orders, accounts payable/receivable, customers, products, and financial entries. Your agent manages the entire back-office.

Get started · free View docs

MIT · runs locally with your own credentials

Limitations

The package manifest does not declare 1 of the 2 variables the code reads.

DetailsSource on GitHub

Package: @codespar/mcp-omie
Version: 0.2.2
npm dist-tag: latest
Category: ERP
Auth: API Key
Country: 🇧🇷 Brazil
License: MIT
Transport: stdio · streamable-http

npm GitHub Server catalog docs

Quickstart

Install, set the credentials, make the first call.

Pick your client. The server runs locally over stdio, with your own credentials.

Add the server to your clientOne config entry. No build step, no SDK required.

Set the environment variables2 variables read by this server's code, listed below.

Restart and make the first callThe agent can call any of the 30 tools. Try list_customers first.

Hosted MCP Build your own server

terminal

# Claude Code
claude mcp add omie -e OMIE_APP_KEY=… -e OMIE_APP_SECRET=… -- npx -y @codespar/mcp-omie@0.2.2
# then: /mcp to confirm the server is connected

Environment variables2 variables

OMIE_APP_KEYRead by the code; the package manifest does not declare it.

OMIE_APP_SECRETAPI key for omierequiredsecret

Names read from the package code (@codespar/mcp-omie@0.2.2). Descriptions and flags come from its manifest. Self-hosted, you hold the credentials.

First call demolist_customers

"List customers from Omie ERP"

tools/calllist_customersresult returned

Tools

What your agent can call.

30 tools, as the package's tools/list returns them.

list_customers

List customers from Omie ERP

create_customer

Create a customer in Omie ERP

list_products

List products from Omie ERP

create_product

Create a product in Omie ERP

create_order

Create a sales order in Omie ERP

list_orders

List sales orders from Omie ERP

list_invoices

List invoices (NF) from Omie ERP

get_financial

List accounts receivable from Omie ERP

create_invoice

Consult a specific NF by ID in Omie ERP

get_company_info

List companies registered in Omie ERP

create_service_order

Create a service order (OS) in Omie ERP

list_service_orders

List service orders (OS) from Omie ERP

Names and descriptions come from the package's tools/list (@codespar/mcp-omie@0.2.2). A kind (read, write, delete) is shown only when the package annotates its tools or each tool was verified one by one; neither exists for this server yet.

Compatibility

MCP is a protocol. Any client that speaks it can mount this server.

The CodeSpar runtime does not route this server. Mount it in your client over stdio · streamable-http.

Protocol

Any MCP client

stdio · streamable-http

Questions

Before you install.

How do I install the Omie MCP server?

Run npx -y @codespar/mcp-omie@0.2.2 and add the config block above to your MCP client: Claude Code, Cursor, Claude Desktop, VS Code, or any MCP-compatible client. No build step, no SDK required.

What can my agent do with Omie?

Omie exposes 30 tools for erp. Your agent calls them directly; the full list is above.

How does Omie authenticate, and how are credentials stored?

Omie uses API Key. Self-hosted, you hold the credentials: the server reads them from its environment variables.

How does Omie handle upstream API changes?

Every server is versioned independently on npm. The command on this page pins 0.2.2, the version whose tools are listed here; your agent keeps running it until you change the version.

Is Omie open source? How do I report a bug?

Yes. Omie is MIT-licensed and published on npm as @codespar/mcp-omie, source on GitHub (link in the Details panel). Report issues on the package repository; security issues go to security@codespar.dev, and we respond within 24 hours.

Pairs well with