@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 Brasil
• 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