Mcp Omie

io.github.codesparPublished by GitHub account codesparv0.2.2Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyFinance Business & Commerce

Server details

Identifier: io.github.codespar/mcp-omie
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account codespar for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.codespar%2Fmcp-omie.svg)](https://sourceweft.com/mcp/io.github.codespar%2Fmcp-omie?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

An MCP server for the Omie ERP that lets an assistant list and create customers, products, orders, invoices, and financial records.

What you can do: List and create customers, products, and companies in Omie ERP. List, create, update, and consult sales orders, and generate invoices from them. List and create service orders and purchase orders. List invoices, accounts receivable, accounts payable, and settle payable titles. Read bank accounts, bank statements, financial movements, DRE chart of accounts, categories, departments, and projects. Create cash ledger entries and stock adjustments, and read current stock position.
When to use it: Useful when an assistant needs to work with Omie ERP data from a chat client, for example to look up customers, check stock or financials, or draft orders and invoices without switching to the Omie interface.
Requirements: Runs locally via npx with Node.js. Requires an Omie account and an app key and app secret from the Omie developer portal, supplied as the OMIE_APP_KEY and OMIE_APP_SECRET environment variables. Network access to the Omie API.

Before you install

The app secret is a credential; keep OMIE_APP_KEY and OMIE_APP_SECRET out of shared configs. Many tools write to the ERP, including creating customers, products, orders, invoices, payable entries, cash entries, and stock adjustments, and settling payments; these change real business records. The README also mentions a separate enterprise offering for agent payments, which is not part of this server.

Installation

In SourceWeft

Open Mcp Omie in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@codespar/mcp-omie

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

[npm] [License: MIT]

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"      }    }  }}

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

Claude Code

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"      }    }  }}

{  "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

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

Source: packages/erp/omie/README.md at commit d0a519a

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v0.2.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts

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