Omie — REST API skill

Você tem acesso à Omie REST API na MCP.AI.

Gestão financeira e contábil na Omie (líder de ERP em nuvem no Brasil), contas a pagar/receber, movimentos financeiros, conciliação, contas correntes, clientes/fornecedores e NF-e, via API oficial JSON (app.omie.com.br). Somente leitura. Pareia com o Banco MCP pra conciliar banco × gestão. Autenticação por app_key + app_secret (gerados na conta Omie, em Configurações → Geral → API).

Base URL

https://api.mcp.ai/api/omie

Todo endpoint é um POST na Base URL + o path abaixo. Os parâmetros vão no corpo JSON.

Autenticação

Inclua em toda request:

Authorization: Bearer sk_live_...
Content-Type: application/json

Gere sua chave em https://app.mcp.ai/settings/api-keys (workspace API key sk_live_…, não expira, revogável). Uma única chave serve pra todos os seus MCPs.

Formato de resposta

{ "ok": true, "tool": "<tool_id>", "result": <payload> }

Exemplo cURL

curl -X POST https://api.mcp.ai/api/omie/get/customer \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{}'

Reportar problemas

Se um endpoint retornar erro, vazio ou dado inesperado, reporte (não desista calado): POST /api/omie/report com { "message": "...", "context"?: "...", "conversation"?: [...] }. Isso notifica o time da MCP.AI.

Endpoints (8)

#### omie_get_customer

Detalha um cliente/fornecedor (ConsultarCliente). Informe codigo_cliente_omie (id Omie) OU codigo_cliente_integracao (sua chave de integração). _(POST /api/omie/get/customer)_

#### omie_list_accounts

Lista as empresas (CNPJ) Omie conectadas a este install — id, label. _(POST /api/omie/list/accounts)_

#### omie_list_checking_accounts

Lista as contas correntes (bancos/caixa) cadastradas na empresa (ListarContasCorrentes). Útil pra mapear cada conta Omie ↔ a conta bancária do Banco MCP na conciliação. _(POST /api/omie/list/checking/accounts)_

#### omie_list_customers

Lista clientes/fornecedores/transportadoras (ListarClientes). Paginado. filters (JSON) aceita os filtros do clientes_list_request da Omie. _(POST /api/omie/list/customers)_

#### omie_list_financial_movements

Lista movimentos financeiros — lançamentos/baixas de contas a pagar, a receber e conta corrente (ListarMovimentos). É a base da CONCILIAÇÃO (pareia com o Banco MCP). Paginado. filters (JSON) usa nom _(POST /api/omie/list/financial/movements)_

#### omie_list_invoices

Lista notas fiscais (NF-e) emitidas (ListarNF). Paginado. filters (JSON) aceita dEmiInicial/dEmiFinal (DD/MM/AAAA), filtrar_por_status (N=vigente, C=cancelada), tpNF (0=entrada,1=saída) etc. _(POST /api/omie/list/invoices)_

#### omie_list_payables

Lista contas a pagar (ListarContasPagar). Paginado. Use filters (JSON) pra filtrar por data (filtrar_por_data_de/ate, DD/MM/AAAA), status, cliente, conta corrente etc. _(POST /api/omie/list/payables)_

#### omie_list_receivables

Lista contas a receber (ListarContasReceber). Paginado. filters (JSON) aceita filtrar_por_data_de/ate, filtrar_por_emissao_de/ate, filtrar_cliente, filtrar_por_status, filtrar_apenas_titulos_em_aber _(POST /api/omie/list/receivables)_

Este MCP também funciona via conexão MCP (Claude / Cursor) em https://api.mcp.ai/p_omie — veja o README. A skill acima é pra consumir a REST API direto (agente próprio / código).