# Omie — MCP server on 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).

By: mcp.ai · official
Page: https://mcp.ai/omie

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_omie?ms=1781045700000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/omie/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/omie/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/omie/skill.md
Postman collection (v2.1): https://mcp.ai/omie/postman.json

## Tools
- omie_get_customer(codigo_cliente_omie?: string, codigo_cliente_integracao?: string, account?: string) — Detalha um cliente/fornecedor (ConsultarCliente). Informe `codigo_cliente_omie` (id Omie) OU `codigo_cliente_integracao` (sua chave de integração).
- omie_list_accounts(account?: string) — Lista as empresas (CNPJ) Omie conectadas a este install — id, label.
- omie_list_checking_accounts(page?: integer, page_size?: integer, filters?: string, account?: string) — 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.
- omie_list_customers(page?: integer, page_size?: integer, filters?: string, account?: string) — Lista clientes/fornecedores/transportadoras (ListarClientes). Paginado. `filters` (JSON) aceita os filtros do clientes_list_request da Omie.
- omie_list_financial_movements(page?: integer, page_size?: integer, filters?: string, account?: string) — 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
- omie_list_invoices(page?: integer, page_size?: integer, filters?: string, account?: string) — 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.
- omie_list_payables(page?: integer, page_size?: integer, filters?: string, account?: string) — 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.
- omie_list_receivables(page?: integer, page_size?: integer, filters?: string, account?: string) — 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

## Example prompts
- "Liste as contas a pagar que vencem esta semana"
- "Quais movimentos financeiros foram baixados nos últimos 7 dias? (pra conciliar com o banco)"
- "Liste as NF-e emitidas em maio"

## Links
Docs: https://mcp.ai/docs/mcps/omie
Website: https://mcp.ai/mcps/omie