# Omie MCP server

Financial & accounting management on Omie (Brazil's leading cloud ERP), payables/receivables, financ

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-mcp-dir-omie-mcp
- Repository: https://github.com/mcp-dir/omie-mcp

## Install
- Endpoint: https://api.mcp.ai/p_omie
- Auth: Not captured

## Setup notes
- Remote endpoint: https://api.mcp.ai/p_omie

## Tools
- omie_list_accounts - Lista as empresas (CNPJ) Omie conectadas a este install — id, label. Endpoint: https://api.mcp.ai/p_omie
- 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. Endpoint: https://api.mcp.ai/p_omie
- omie_get_payable - Detalha uma conta a pagar (ConsultarContaPagar). Informe `codigo_lancamento_omie` (id Omie) OU `codigo_lancamento_integracao`. Use antes de editar (omie_update_payable). Endpoint: https://api.mcp.ai/p_omie
- omie_create_payable - Lança (cria) uma conta a pagar (IncluirContaPagar). `data` é um JSON string com os campos do payload da doc oficial — obrigatórios: codigo_lancamento_integracao (sua chave única), codigo_cliente_fornecedor (id do fornecedor, veja omie_list_customers), data_vencimento (DD/MM/AAAA), valor_documento, codigo_categoria, data_previsao (DD/MM/AAAA), id_conta_corrente (veja omie_list_checking_accounts). Doc: developer.omie.com.br (financas/contapagar). Endpoint: https://api.mcp.ai/p_omie
- omie_update_payable - Edita uma conta a pagar existente (AlterarContaPagar). `data` é um JSON string que DEVE conter a chave do lançamento (codigo_lancamento_omie OU codigo_lancamento_integracao) + os campos a alterar (ex.: data_vencimento, valor_documento, codigo_categoria, observacao). Consulte antes com omie_get_payable. Endpoint: https://api.mcp.ai/p_omie
- omie_settle_payable - Dá baixa (liquida/paga) uma conta a pagar (LancarPagamento). `data` é um JSON string com a chave do lançamento (codigo_lancamento, o id Omie — igual ao codigo_lancamento_omie do get — OU codigo_lancamento_integracao) + os dados da baixa: codigo_baixa_integracao (sua chave única da baixa, texto livre), valor, data (DD/MM/AAAA), codigo_conta_corrente (veja omie_list_checking_accounts) e opcional observacao. É o par pra conciliar com o Banco MCP. Endpoint: https://api.mcp.ai/p_omie
- omie_delete_payable - APAGA (exclui em definitivo) uma conta a pagar (ExcluirContaPagar). Informe `codigo_lancamento_omie` (id Omie) OU `codigo_lancamento_integracao`. Ação IRREVERSÍVEL — confirme com o usuário antes de chamar. Consulte antes com omie_get_payable pra ter certeza do lançamento. Endpoint: https://api.mcp.ai/p_omie
- 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_aberto (S/N) etc. Endpoint: https://api.mcp.ai/p_omie
- omie_get_receivable - Detalha uma conta a receber (ConsultarContaReceber). Informe `codigo_lancamento_omie` (id Omie) OU `codigo_lancamento_integracao`. Use antes de editar (omie_update_receivable). Endpoint: https://api.mcp.ai/p_omie
- omie_create_receivable - Lança (cria) uma conta a receber (IncluirContaReceber). `data` é um JSON string com os campos do payload da doc oficial — obrigatórios: codigo_lancamento_integracao (sua chave única), codigo_cliente_fornecedor (id do cliente, veja omie_list_customers), data_vencimento (DD/MM/AAAA), valor_documento, codigo_categoria, data_previsao (DD/MM/AAAA), id_conta_corrente (veja omie_list_checking_accounts). Doc: developer.omie.com.br (financas/contareceber). Endpoint: https://api.mcp.ai/p_omie
- omie_update_receivable - Edita uma conta a receber existente (AlterarContaReceber). `data` é um JSON string que DEVE conter a chave do lançamento (codigo_lancamento_omie OU codigo_lancamento_integracao) + os campos a alterar (ex.: data_vencimento, valor_documento, codigo_categoria, observacao). Consulte antes com omie_get_receivable. Endpoint: https://api.mcp.ai/p_omie
- omie_settle_receivable - Dá baixa (liquida/recebe) uma conta a receber (LancarRecebimento). `data` é um JSON string com a chave do lançamento (codigo_lancamento, o id Omie — igual ao codigo_lancamento_omie do get — OU codigo_lancamento_integracao) + os dados da baixa: codigo_baixa_integracao (sua chave única da baixa, texto livre), valor, data (DD/MM/AAAA), codigo_conta_corrente (veja omie_list_checking_accounts) e opcional observacao. É o par pra conciliar com o Banco MCP. Endpoint: https://api.mcp.ai/p_omie
- omie_delete_receivable - APAGA (exclui em definitivo) uma conta a receber (ExcluirContaReceber). Informe `codigo_lancamento_omie` (id Omie) OU `codigo_lancamento_integracao`. Ação IRREVERSÍVEL — confirme com o usuário antes de chamar. Consulte antes com omie_get_receivable pra ter certeza do lançamento. Endpoint: https://api.mcp.ai/p_omie
- 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 nomes Hungarian da Omie: dDtPagtoDe/dDtPagtoAte, dDtVencDe/dDtVencAte, cTpLancamento ("CP","CR","BX"), cStatus, nCodCC (conta corrente), nCodCliente etc. Endpoint: https://api.mcp.ai/p_omie
- 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. Endpoint: https://api.mcp.ai/p_omie
- omie_get_checking_account_balance - SALDO ATUAL de uma conta corrente (ListarExtrato do módulo financas/extrato) — o saldo REAL de hoje, ao contrário de omie_list_checking_accounts, que só traz o `saldo_inicial` numa data fixa (ponto de partida contábil). Base da CONCILIAÇÃO Banco × Omie. Identifique a conta por `conta` (nome OU id), ou por `nCodCC` (id Omie) ou `cCodCCInt` (chave de integração). Por padrão traz só os saldos (nSaldoAtual, nSaldoAnterior, nSaldoDisponivel, nSaldoConciliado, nSaldoProvisorio); passe `incluir_movimentos:true` pra vir também a lista de lançamentos do período. `data_inicial`/`data_final` (AAAA-MM-DD ou DD/MM/AAAA) definem o período dos movimentos, default hoje. Endpoint: https://api.mcp.ai/p_omie
- omie_create_checking_account - Cria uma conta corrente (banco/caixa/cartão) na empresa (IncluirContaCorrente). `data` é um JSON string com os campos da doc oficial — comuns: cCodCCInt (sua chave de integração), tipo_conta_corrente ("CX" caixa, "CC" conta corrente, "CA" cartão, "AD" adiantamento), codigo_banco, descricao, nome_agencia, numero_conta_corrente. Doc: developer.omie.com.br (geral/contacorrente). Endpoint: https://api.mcp.ai/p_omie
- omie_update_checking_account - Edita uma conta corrente existente (AlterarContaCorrente). `data` é um JSON string que DEVE conter a chave da conta (nCodCC id Omie OU cCodCCInt chave de integração) + os campos a alterar. Consulte antes com omie_list_checking_accounts. Endpoint: https://api.mcp.ai/p_omie
- omie_delete_checking_account_entry - APAGA/estorna um LANÇAMENTO de conta corrente (ExcluirLancCC) — movimentos da conta corrente como transferências, aplicações, resgates e tarifas, diferente de conta a pagar/receber (use omie_delete_payable/omie_delete_receivable pra títulos). Informe `nCodLanc` (id Omie do lançamento) OU `cCodIntLanc` (sua chave de integração). Ação IRREVERSÍVEL, confirme com o usuário antes de chamar. Doc: developer.omie.com.br (financas/contacorrentelancamentos). Endpoint: https://api.mcp.ai/p_omie
- omie_list_customers - Lista clientes/fornecedores/transportadoras (ListarClientes). Paginado. `filters` (JSON) aceita os filtros do clientes_list_request da Omie. Endpoint: https://api.mcp.ai/p_omie
- omie_get_customer - Detalha um cliente/fornecedor (ConsultarCliente). Informe `codigo_cliente_omie` (id Omie) OU `codigo_cliente_integracao` (sua chave de integração). Endpoint: https://api.mcp.ai/p_omie
- omie_create_customer - Cadastra um cliente ou fornecedor (IncluirCliente). Na Omie cliente e fornecedor são o MESMO cadastro; o que muda é a classificação. `data` é um JSON string com os campos da doc oficial — obrigatórios: codigo_cliente_integracao (sua chave única), razao_social, cnpj_cpf (ou nome + doc pra PF); comuns: nome_fantasia, email, telefone1_numero, endereco, cidade, estado, cep. Pra marcar como fornecedor use tags: [{ "tag": "Fornecedor" }] (ou "Cliente"). Doc: developer.omie.com.br (geral/clientes). Endpoint: https://api.mcp.ai/p_omie
- omie_update_customer - Edita um cliente/fornecedor existente (AlterarCliente). `data` é um JSON string que DEVE conter a chave do cadastro (codigo_cliente_omie id Omie OU codigo_cliente_integracao) + os campos a alterar (ex.: razao_social, email, telefone1_numero, endereco). Consulte antes com omie_get_customer. Endpoint: https://api.mcp.ai/p_omie
- omie_list_categories - Lista as categorias / plano de contas da empresa (ListarCategorias). Paginado. Cada categoria tem um `codigo_categoria` — é o campo exigido ao lançar uma conta a pagar/receber (omie_create_payable/receivable). Endpoint: https://api.mcp.ai/p_omie
- omie_list_departments - Lista os departamentos / centros de custo da empresa (ListarDepartamentos). Paginado. Cada um tem um `codigo` usado pra ratear um lançamento por departamento. Endpoint: https://api.mcp.ai/p_omie
- omie_list_projects - Lista os projetos da empresa (ListarProjetos). Paginado. Cada projeto tem um `codigo` que pode ser vinculado a um lançamento financeiro. Endpoint: https://api.mcp.ai/p_omie
- omie_list_document_types - Lista os tipos de documento (dinheiro, boleto, cartão, cheque etc.) — PesquisarTipoDocumento. Não é paginado (lista fixa e curta). Cada tipo tem um `codigo` usado em baixas e lançamentos. Endpoint: https://api.mcp.ai/p_omie
- 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. Endpoint: https://api.mcp.ai/p_omie
- omie_lancar - Atalho: lança uma conta a PAGAR ou a RECEBER em UMA chamada, resolvendo os códigos por NOME no servidor (fornecedor/cliente, categoria e conta corrente). Substitui o fluxo de 4-5 chamadas (list_customers + list_categories + list_checking_accounts + create). Aceita nome OU código em cada campo; se um nome não bater ou for ambíguo, retorna erro com as opções ANTES de criar (não chuta). Datas aceitam AAAA-MM-DD ou DD/MM/AAAA. Use isto por padrão pra lançar; as tools omie_create_* continuam pra quem já tem os códigos. Endpoint: https://api.mcp.ai/p_omie
- show_version - Show the current MCP platform and adapter versions. Endpoint: https://api.mcp.ai/p_omie
- report_bug - Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction. Endpoint: https://api.mcp.ai/p_omie
- connect - Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs. Endpoint: https://api.mcp.ai/p_omie
- toolkit_info - Returns the current toolkit state: installed MCPs, their connection status, and how many catalog tools each exposes. Endpoint: https://api.mcp.ai/p_omie
- marketplace - The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. Endpoint: https://api.mcp.ai/p_omie
- authenticate - MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes, or with no args to get the link. Endpoint: https://api.mcp.ai/p_omie

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.github.mcp-dir
- Version: 0.1.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jun 10, 2026
- Source: https://registry.modelcontextprotocol.io