io.github.codespar/mcp-omie MCP Server

MCP server for Omie that provides access to ERP data including customers, products, orders, invoices, and financials. It is published under @codespar/mcp-omie and is tagged with topics spanning Model Context Protocol, Brazil, and open finance.

🛠️ Key Features

MCP server for Omie (ERP)
Handles entities: customers, products, orders, invoices, financials
Topics include model-context-protocol, mcp, nfe, open-finance, payments, pix, fintech, agentic-commerce

🚀 Use Cases

Integrate AI/LLM tools with Omie ERP workflows
Work with invoice and financial data for Brazil-related use cases
Support payments-related contexts (payments, PIX)

⚡ Developer Benefits

Clear MCP purpose: “ERP, customers, products, orders, invoices, financials”
MIT-licensed package (@codespar/mcp-omie)
Designed to be used from Claude Desktop via an MCP server configuration snippet (command npx, package -y @codespar/mcp-omie)

⚠️ Limitations

The provided excerpt includes configuration details only; no specific MCP tools, schemas, or endpoints are described here.

@codespar/mcp-omie

MCP server for Omie — ERP with customers, products, orders, invoices, and financials

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

json

{
  "mcpServers": {
    "omie": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-omie"],
      "env": {
        "OMIE_APP_KEY": "your-app-key",
        "OMIE_APP_SECRET": "your-app-secret"
      }
    }
  }
}

Claude Code

bash

claude mcp add omie -- npx @codespar/mcp-omie

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

json

{
  "servers": {
    "omie": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-omie"],
      "env": {
        "OMIE_APP_KEY": "your-app-key",
        "OMIE_APP_SECRET": "your-app-secret"
      }
    }
  }
}

Tools (30)

Tool	Purpose
`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
`create_purchase_order`	Create a purchase order in Omie ERP
`list_purchase_orders`	List purchase orders from Omie ERP
`get_bank_accounts`	List registered bank accounts in Omie ERP
`create_account_payable`	Create an accounts payable (AP) entry in Omie ERP
`list_accounts_payable`	List accounts payable (AP) titles in Omie ERP
`pay_account_payable`	Settle / record payment (baixa) for an AP title in Omie ERP
`list_dre`	List DRE (income statement) chart of accounts in Omie ERP
`get_bank_statement`	Retrieve bank account statement (extrato) for a period from Omie ERP
`list_categories`	List chart of accounts categories in Omie ERP
`list_departments`	List departments (cost centers) in Omie ERP
`list_projects`	List projects in Omie ERP
`create_cash_entry`	Create a bank account ledger entry (lançamento de conta corrente) in Omie ERP
`list_financial_movements`	List unified financial movements (AP + AR + CC) in Omie ERP
`create_stock_adjustment`	Create an inventory adjustment (entry/exit/balance) in Omie ERP
`get_stock_position`	Get current stock position / balance in Omie ERP
`update_sales_order`	Alter an existing sales order in Omie ERP
`get_sales_order`	Consult a specific sales order by ID or integration code in Omie ERP
`invoice_sales_order`	Generate an invoice (NF) from an existing sales order in Omie ERP

Authentication

Omie uses JSON-RPC style requests with app_key and app_secret in the request body.

Sandbox / Testing

Omie provides a sandbox via app registration. Create an app to get test credentials.

Get your credentials

Go to Omie Developer Portal
Create an account
Register an application to get app key and secret
Set the environment variables

Environment Variables

Variable	Required	Description
`OMIE_APP_KEY`	Yes	Omie app key
`OMIE_APP_SECRET`	Yes	Omie app secret

Roadmap

v0.3 (planned)

create_production_order — Create a production order
emit_nfe — Emit NF-e (native emission, not import)
reconcile_bank_transaction — Bank reconciliation matching
create_service_contract — Service contracts CRUD
create_custom_field — Merchant custom fields

Want to contribute? Open a PR or request a tool.

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

io.github.codespar/mcp-omie