mcp-omie

@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:

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

Claude Code

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

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.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

1. Go to Omie Developer Portal
2. Create an account
3. Register an application to get app key and secret
4. 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.

Links

• Omie Website
• Omie API Documentation
• MCP Dev LATAM
• Landing Page

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