Skip to main content
OM

Omie

v0.2.0API Key

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

30 tools1 env vars๐Ÿ‡ง๐Ÿ‡ท Brazilstable on npm

Install

terminal
$ npm install @codespar/mcp-omie

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

claude_desktop_config.json
{
  "mcpServers": {
    "omie": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-omie"
      ],
      "env": {
        "OMIE_APP_SECRET": "<your_omie_app_secret>"
      }
    }
  }
}

After restart, your agent can call any of the 30 tools below โ€” try list_customers first.

Environment variables ยท 1

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

OMIE_APP_SECRET
requiredsecret

API key for omie

Available tools ยท 30

Each tool is independent โ€” your agent loads only what it needs to reduce context and response time.

READlist_customers
List customers from Omie ERP
WRITEcreate_customer
Create a customer in Omie ERP
READlist_products
List products from Omie ERP
WRITEcreate_product
Create a product in Omie ERP
WRITEcreate_order
Create a sales order in Omie ERP
READlist_orders
List sales orders from Omie ERP
READlist_invoices
List invoices (NF) from Omie ERP
READget_financial
List accounts receivable from Omie ERP

Compatible frameworks

MCP is a protocol โ€” any framework that speaks it can mount this server.

Claude Agent SDKAnthropic
OpenAI AgentsOpenAI
Vercel AI SDKVercel
LangChainLangChain
LlamaIndexLlamaIndex
CrewAICrewAI
MastraMastra
Any MCP clientProtocol

Frequently asked questions

All credentials are encrypted at rest in an isolated vault scoped per organization. OAuth2 tokens are automatically refreshed before expiry. Your agent code never sees raw secrets โ€” it receives scoped, short-lived session tokens.
Servers โ€” Every LatAm commerce API your agent needs | CodeSpar