io.github.codespar/mcp-omie
NPM · @CODESPAR/MCP-OMIE · SCANNED SEP 24
MCP server for Omie — ERP, customers, products, orders, invoices, financials
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security98
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- 31 of 95 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency48
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 93 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability67
- AI-judged instruction clarity (good).Pass
- Tool/resource definitions use about 2638 tokens (~87/item across 30 items; 30 tools + 0 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management83
- Stability observed for 25 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Tool Safety75
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- 0 of 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "pay_account_payable" implies "pay" and declares no destructiveHint at all, which the MCP spec reads as destructive by default. See how to fix → Fail
- An AI judge read all 31 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
How do I install the io.github.codespar/mcp-omie server?
io.github.codespar/mcp-omie runs locally as an npm package, launched with npx -y @codespar/mcp-omie. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · @codespar/mcp-omie
claude mcp add codespar-mcp-omie -- npx -y @codespar/mcp-omie
{
"mcpServers": {
"codespar-mcp-omie": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-omie"
]
}
}
} {
"servers": {
"codespar-mcp-omie": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-omie"
]
}
}
} codex mcp add codespar-mcp-omie -- npx -y @codespar/mcp-omie
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"codespar-mcp-omie": {
"type": "local",
"command": [
"npx",
"-y",
"@codespar/mcp-omie"
],
"enabled": true
}
}
} openclaw mcp add codespar-mcp-omie --command npx --arg -y --arg @codespar/mcp-omie
mcp_servers:
codespar-mcp-omie:
command: "npx"
args: ["-y", "@codespar/mcp-omie"] {
"McpServers": {
"codespar-mcp-omie": {
"Transport": "stdio",
"Command": "npx",
"Arguments": [
"-y",
"@codespar/mcp-omie"
]
}
}
} assistant mcp add codespar-mcp-omie -t stdio -c npx -a -y @codespar/mcp-omie
{
"mcpServers": {
"codespar-mcp-omie": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-omie"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 23 Sept 26 −3
- Stability: pass → 0.80 functional
- 22 Sept 26 +1
- Stability: 0.97 → pass security
- 20 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 90 to 93. That category is still filling its 30-day observation window: 27 days of observed history at the previous scan, 28 at this one. The score rises as the window fills, whether or not the server changes.
- 18 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 83 to 87. That category is still filling its 30-day observation window: 25 days of observed history at the previous scan, 26 at this one. The score rises as the window fills, whether or not the server changes.
- 16 Sept 26 −3
- Stability: pass → 0.80 functional
- 15 Sept 26 +1
- Stability: 0.97 → pass security
- 13 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 90 to 93. That category is still filling its 30-day observation window: 27 days of observed history at the previous scan, 28 at this one. The score rises as the window fills, whether or not the server changes.
- 11 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 83 to 87. That category is still filling its 30-day observation window: 25 days of observed history at the previous scan, 26 at this one. The score rises as the window fills, whether or not the server changes.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 24 Sept 2026 · Analysed npm/@codespar/mcp-omie@0.2.2
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | npm |
Background: How many MCP packages publish verified provenance →
Dependencies 95 packages
| Packages resolved | 95 |
|---|---|
| Stale | 31 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
create_account_payable ~150
Create an accounts payable (AP) entry in Omie ERP
| Name | Type | Req | Description |
|---|---|---|---|
| codigo_categoria | string | yes | Category code (chart of accounts) |
| codigo_cliente_fornecedor | number | yes | Omie supplier ID |
| codigo_lancamento_integracao | string | yes | Integration code (unique) |
| data_previsao | string | – | Expected payment date (DD/MM/YYYY) |
| data_vencimento | string | yes | Due date (DD/MM/YYYY) |
| id_conta_corrente | number | – | Bank account ID |
| numero_documento | string | – | Document/invoice number |
| observacao | string | – | Notes |
| valor_documento | number | yes | Document value in BRL |
No output schema declared.
No examples provided.
create_cash_entry ~111
Create a bank account ledger entry (lançamento de conta corrente) in Omie ERP
| Name | Type | Req | Description |
|---|---|---|---|
| cabecalho | object | yes | Entry header: { cCodIntLanc, nCodCC, dDtLanc, nValorLanc, cNatureza (E=entrada, S=saida), cTipo (DEB/CRE), cHistorico } |
| detalhes | object | – | Entry details: { cCodCateg, nCodCliente, cObs, nCodProjeto, nCodDepto } |
No output schema declared.
No examples provided.
create_customer ~129
Create a customer in Omie ERP
| Name | Type | Req | Description |
|---|---|---|---|
| bairro | string | – | Neighborhood |
| cep | string | – | Postal code |
| cidade | string | – | City |
| cnpj_cpf | string | yes | CPF or CNPJ |
| string | – | Email address | |
| endereco | string | – | Street address |
| endereco_numero | string | – | Address number |
| estado | string | – | State (UF) |
| nome_fantasia | string | – | Trade name |
| razao_social | string | yes | Legal name |
| telefone1_numero | string | – | Phone number |
No output schema declared.
No examples provided.
create_invoice ~32
Consult a specific NF by ID in Omie ERP
| Name | Type | Req | Description |
|---|---|---|---|
| nIdNF | number | yes | Omie NF ID |
No output schema declared.
No examples provided.
create_order ~90
Create a sales order in Omie ERP
| Name | Type | Req | Description |
|---|---|---|---|
| codigo_cliente | number | yes | Omie customer ID |
| codigo_pedido_integracao | string | yes | Integration order code (unique) |
| data_previsao | string | yes | Expected date (DD/MM/YYYY) |
| frete | object | – | Shipping details |
| itens | array | yes | Array of order items (produto, quantidade, valor_unitario) |
No output schema declared.
No examples provided.
create_product ~80
Create a product in Omie ERP
| Name | Type | Req | Description |
|---|---|---|---|
| codigo | string | yes | Product code (internal) |
| descricao | string | yes | Product description |
| ncm | string | yes | NCM code (tax classification) |
| unidade | string | yes | Unit of measure (UN, KG, etc.) |
| valor_unitario | number | yes | Unit price in BRL |
No output schema declared.
No examples provided.
create_purchase_order ~94
Create a purchase order in Omie ERP
| Name | Type | Req | Description |
|---|---|---|---|
| codigo_fornecedor | number | yes | Omie supplier ID |
| codigo_pedido_integracao | string | yes | Integration order code (unique) |
| data_previsao | string | yes | Expected date (DD/MM/YYYY) |
| itens | array | yes | Array of items (produto, quantidade, valor_unitario) |
| observacoes | string | – | Order notes/observations |
No output schema declared.
No examples provided.
create_service_order ~97
Create a service order (OS) in Omie ERP
| Name | Type | Req | Description |
|---|---|---|---|
| codigo_cliente | number | yes | Omie customer ID |
| codigo_pedido_integracao | string | yes | Integration order code (unique) |
| data_previsao | string | yes | Expected date (DD/MM/YYYY) |
| observacoes | string | – | Order notes/observations |
| servicos | array | yes | Array of services (descricao, valor_unitario, quantidade) |
No output schema declared.
No examples provided.
create_stock_adjustment ~157
Create an inventory adjustment (entry/exit/balance) in Omie ERP
| Name | Type | Req | Description |
|---|---|---|---|
| codigo_local_estoque | number | – | Warehouse location ID |
| codigo_motivo | number | – | Reason code |
| codigo_produto | number | – | Omie product ID |
| codigo_produto_integracao | string | – | Product integration code (alternative) |
| data_ajuste | string | yes | Adjustment date (DD/MM/YYYY) |
| observacao | string | – | Notes |
| quantidade | number | yes | Quantity |
| tipo_ajuste | string | yes | Adjustment type: ENT (entry), SAI (exit), SLD (balance), TRF (transfer) |
| valor | number | – | Unit value in BRL |
No output schema declared.
No examples provided.
get_bank_accounts ~48
List registered bank accounts in Omie ERP
| Name | Type | Req | Description |
|---|---|---|---|
| pagina | number | – | Page number (default 1) |
| registros_por_pagina | number | – | Records per page (default 50) |
No output schema declared.
No examples provided.
get_bank_statement ~105
Retrieve bank account statement (extrato) for a period from Omie ERP
| Name | Type | Req | Description |
|---|---|---|---|
| cCodIntCC | string | – | Bank account integration code (alternative to nCodCC) |
| cExibirApenasSaldo | string | – | Show only balances (S/N) |
| dPeriodoFinal | string | yes | End date (DD/MM/YYYY) |
| dPeriodoInicial | string | yes | Start date (DD/MM/YYYY) |
| nCodCC | number | – | Bank account ID |
No output schema declared.
No examples provided.
get_company_info ~47
List companies registered in Omie ERP
| Name | Type | Req | Description |
|---|---|---|---|
| pagina | number | – | Page number (default 1) |
| registros_por_pagina | number | – | Records per page (default 50) |
No output schema declared.
No examples provided.
get_financial ~84
List accounts receivable from Omie ERP
| Name | Type | Req | Description |
|---|---|---|---|
| dDtEmiFinal | string | – | End emission date (DD/MM/YYYY) |
| dDtEmiInicial | string | – | Start emission date (DD/MM/YYYY) |
| pagina | number | – | Page number (default 1) |
| registros_por_pagina | number | – | Records per page (default 50) |
No output schema declared.
No examples provided.
get_sales_order ~53
Consult a specific sales order by ID or integration code in Omie ERP
| Name | Type | Req | Description |
|---|---|---|---|
| codigo_pedido | number | – | Omie order ID |
| codigo_pedido_integracao | string | – | Integration order code (alternative) |
No output schema declared.
No examples provided.
get_stock_position ~102
Get current stock position / balance in Omie ERP
| Name | Type | Req | Description |
|---|---|---|---|
| cExibirTodos | string | – | Include items with zero stock (S/N) |
| codigo_local_estoque | number | – | Filter by warehouse location ID |
| dDataPosicao | string | – | Position reference date (DD/MM/YYYY) |
| nPagina | number | – | Page number (default 1) |
| nRegPorPagina | number | – | Records per page (default 50) |
No output schema declared.
No examples provided.
invoice_sales_order ~53
Generate an invoice (NF) from an existing sales order in Omie ERP
| Name | Type | Req | Description |
|---|---|---|---|
| cCodIntPed | string | – | Integration order code (alternative) |
| nCodPed | number | – | Omie order ID |
No output schema declared.
No examples provided.
list_accounts_payable ~111
List accounts payable (AP) titles in Omie ERP
| Name | Type | Req | Description |
|---|---|---|---|
| dDtVencAte | string | – | Due date to (DD/MM/YYYY) |
| dDtVencDe | string | – | Due date from (DD/MM/YYYY) |
| pagina | number | – | Page number (default 1) |
| registros_por_pagina | number | – | Records per page (default 50) |
| status_titulo | string | – | Title status (ABERTO, LIQUIDADO, etc.) |
No output schema declared.
No examples provided.
list_categories ~48
List chart of accounts categories in Omie ERP
| Name | Type | Req | Description |
|---|---|---|---|
| pagina | number | – | Page number (default 1) |
| registros_por_pagina | number | – | Records per page (default 50) |
No output schema declared.
No examples provided.
list_customers ~68
List customers from Omie ERP
| Name | Type | Req | Description |
|---|---|---|---|
| clientesFiltro | object | – | Filter object (nome_fantasia, cnpj_cpf, etc.) |
| pagina | number | – | Page number (default 1) |
| registros_por_pagina | number | – | Records per page (default 50) |
No output schema declared.
No examples provided.
list_departments ~50
List departments (cost centers) in Omie ERP
| Name | Type | Req | Description |
|---|---|---|---|
| pagina | number | – | Page number (default 1) |
| registros_por_pagina | number | – | Records per page (default 50) |
No output schema declared.
No examples provided.
list_dre ~44
List DRE (income statement) chart of accounts in Omie ERP
| Name | Type | Req | Description |
|---|---|---|---|
| apenasContasAtivas | string | – | Only active accounts (S/N, default S) |
No output schema declared.
No examples provided.
list_financial_movements ~143
List unified financial movements (AP + AR + CC) in Omie ERP
| Name | Type | Req | Description |
|---|---|---|---|
| cNatureza | string | – | Nature (R=receivable, P=payable, T=all) |
| cStatus | string | – | Status (ABERTO, LIQUIDADO, VENCIDO, etc.) |
| dDtPagtoAte | string | – | Payment date to (DD/MM/YYYY) |
| dDtPagtoDe | string | – | Payment date from (DD/MM/YYYY) |
| nPagina | number | – | Page number (default 1) |
| nRegPorPagina | number | – | Records per page (default 50) |
No output schema declared.
No examples provided.
list_invoices ~83
List invoices (NF) from Omie ERP
| Name | Type | Req | Description |
|---|---|---|---|
| dEmiFinal | string | – | End emission date (DD/MM/YYYY) |
| dEmiInicial | string | – | Start emission date (DD/MM/YYYY) |
| pagina | number | – | Page number (default 1) |
| registros_por_pagina | number | – | Records per page (default 50) |
No output schema declared.
No examples provided.
list_orders ~80
List sales orders from Omie ERP
| Name | Type | Req | Description |
|---|---|---|---|
| etapa | string | – | Order stage filter (10=Pedido, 20=Separar, 50=Faturar, 60=Faturado) |
| pagina | number | – | Page number (default 1) |
| registros_por_pagina | number | – | Records per page (default 50) |
No output schema declared.
No examples provided.
list_products ~60
List products from Omie ERP
| Name | Type | Req | Description |
|---|---|---|---|
| apenas_importado_api | string | – | Only API-imported products |
| pagina | number | – | Page number (default 1) |
| registros_por_pagina | number | – | Records per page (default 50) |
No output schema declared.
No examples provided.
list_projects ~60
List projects in Omie ERP
| Name | Type | Req | Description |
|---|---|---|---|
| apenas_importado_api | string | – | Only API-imported projects |
| pagina | number | – | Page number (default 1) |
| registros_por_pagina | number | – | Records per page (default 50) |
No output schema declared.
No examples provided.
list_purchase_orders ~74
List purchase orders from Omie ERP
| Name | Type | Req | Description |
|---|---|---|---|
| etapa | string | – | Order stage filter (10=Pedido, 50=Receber, 60=Recebido) |
| pagina | number | – | Page number (default 1) |
| registros_por_pagina | number | – | Records per page (default 50) |
No output schema declared.
No examples provided.
list_service_orders ~84
List service orders (OS) from Omie ERP
| Name | Type | Req | Description |
|---|---|---|---|
| etapa | string | – | Order stage filter (10=OS, 20=Executar, 50=Faturar, 60=Faturado) |
| pagina | number | – | Page number (default 1) |
| registros_por_pagina | number | – | Records per page (default 50) |
No output schema declared.
No examples provided.
pay_account_payable ~132
Settle / record payment (baixa) for an AP title in Omie ERP
| Name | Type | Req | Description |
|---|---|---|---|
| codigo_baixa | string | yes | Settlement integration code (unique) |
| codigo_conta_corrente | number | yes | Bank account ID used for the payment |
| codigo_lancamento | number | – | Omie AP title ID |
| codigo_lancamento_integracao | string | – | Integration code (alternative to codigo_lancamento) |
| data | string | yes | Payment date (DD/MM/YYYY) |
| observacao | string | – | Payment notes |
| valor | number | yes | Paid amount in BRL |
No output schema declared.
No examples provided.
update_sales_order ~102
Alter an existing sales order in Omie ERP
| Name | Type | Req | Description |
|---|---|---|---|
| cabecalho | object | yes | Order header: { codigo_pedido, codigo_pedido_integracao, codigo_cliente, data_previsao, etapa, ... } |
| frete | object | – | Shipping details |
| informacoes_adicionais | object | – | Additional info (codigo_vendedor, etc.) |
| itens | array | – | Updated order items |
| observacoes | object | – | Order observations |
No output schema declared.
No examples provided.
What is the io.github.codespar/mcp-omie server?
io.github.codespar/mcp-omie is listed in the public MCP registry as io.github.codespar/mcp-omie. MCP server for Omie, ERP, customers, products, orders, invoices, financials. This page covers its npm package (@codespar/mcp-omie).
Is the io.github.codespar/mcp-omie server safe to use?
io.github.codespar/mcp-omie scores 79 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 24 September 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the io.github.codespar/mcp-omie server expose?
io.github.codespar/mcp-omie exposes 30 tools: list_customers, create_customer, list_products, create_product, create_order, and 25 more. Their descriptions and schemas cost roughly 2,571 tokens of context every time the server is loaded.
Is the io.github.codespar/mcp-omie server still maintained?
io.github.codespar/mcp-omie is still listed as active in the MCP registry. We last reached this channel on 24 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the io.github.codespar/mcp-omie server under?
io.github.codespar/mcp-omie declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.