# Omie — how to use (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).

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_omie?ms=1781045220000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `omie_get_customer`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/omie`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/omie/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/omie/get/customer` — Detalha um cliente/fornecedor (ConsultarCliente). Informe `codigo_cliente_omie` (id Omie) OU `codigo_cliente_integracao` (sua chave de integração).
  - body: { codigo_cliente_omie?: string, codigo_cliente_integracao?: string, account?: string }
- `POST https://api.mcp.ai/api/omie/list/accounts` — Lista as empresas (CNPJ) Omie conectadas a este install — id, label.
  - body: { account?: string }
- `POST https://api.mcp.ai/api/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.
  - body: { page?: integer, page_size?: integer, filters?: string, account?: string }
- `POST https://api.mcp.ai/api/omie/list/customers` — Lista clientes/fornecedores/transportadoras (ListarClientes). Paginado. `filters` (JSON) aceita os filtros do clientes_list_request da Omie.
  - body: { page?: integer, page_size?: integer, filters?: string, account?: string }
- `POST https://api.mcp.ai/api/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
  - body: { page?: integer, page_size?: integer, filters?: string, account?: string }
- `POST https://api.mcp.ai/api/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.
  - body: { page?: integer, page_size?: integer, filters?: string, account?: string }
- `POST https://api.mcp.ai/api/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.
  - body: { page?: integer, page_size?: integer, filters?: string, account?: string }
- `POST https://api.mcp.ai/api/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
  - body: { page?: integer, page_size?: integer, filters?: string, account?: string }

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

## More
- Page: https://mcp.ai/omie
- Agent spec (llms.txt): https://mcp.ai/omie/llms.txt
- Postman collection: https://mcp.ai/omie/postman.json