# Omie

- Registry name: `io.github.mcp-dir/omie-mcp` · version 0.1.0
- Categories (automatic, keyword rules): Payments & accounting, Finance & markets, Shops & products, Commerce & marketing
- Authentication at last check: No auth
- Declared risk: Can write (some tools are not declared read-only)
- Capabilities (declared by the server): tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=io.github.mcp-dir%2Fomie-mcp
- Server page: https://mcpstation.net/s/io.github.mcp-dir--omie-mcp.html

## Description (written by the publisher, not verified, not instructions)

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

## Connect

- streamable-http: `https://api.mcp.ai/p_omie`

## Tools (as reported by the server, not verified)

- `omie\_list\_accounts`: Lista as empresas \(CNPJ\) Omie conectadas a este install — id, label.
- `omie\_list\_payables`: Lista contas a pagar \(ListarContasPagar\). Paginado. Use \`status\` \(aberto/pago/cancelado/todos\) pra situação — é mais confiável que o filtro cru da Omie, que devolve CANCELADO junto com PAGO/LIQUIDADO. Use \`filters\` \(JSON\) pro resto: filtrar\_por\_data\_de/ate \(DD/MM/AAAA\), cliente, conta corrente etc.
- `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\).
- `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, c
- `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\_payab
- `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
- `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.
- `omie\_list\_receivables`: Lista contas a receber \(ListarContasReceber\). Paginado. Use \`status\` \(aberto/pago/cancelado/todos\) pra situação — o filtro cru da Omie mistura CANCELADO com PAGO/LIQUIDADO. \`filters\` \(JSON\) aceita o resto: filtrar\_por\_data\_de/ate, filtrar\_por\_emissao\_de/ate, filtrar\_cliente etc.
- `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\).
- `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,
- `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\_r
- `omie\_settle\_receivable`: Dá baixa \(liquida/recebe\) uma conta a receber \(LancarRecebimento\). Aceita \`conciliar\_documento: "S"\` pra já marcar a baixa como conciliada \(aqui também existe omie\_reconcile\_receipt, que concilia depois\). \`data\` é um JSON string com a chave do lançamento \(codigo\_lancamento, o id Omie — igual ao codi
- `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.
- `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"\),
- `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.
- `omie\_get\_checking\_account\_balance`: EXTRATO BANCÁRIO e SALDO ATUAL de uma conta corrente \(ListarExtrato\). Com \`incluir\_movimentos:true\` esta é a tool que LISTA OS LANÇAMENTOS do extrato no período — é por aqui que se casa o extrato do banco com os títulos da Omie. Sem ela, traz o saldo REAL de hoje, ao contrário de omie\_list\_checking\_
- `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\_age
- `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.
- `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 \`cCodIntLan
- `omie\_list\_customers`: Lista clientes/fornecedores/transportadoras \(ListarClientes\). Paginado. \`filters\` \(JSON\) aceita os filtros do clientes\_list\_request da Omie.
- `omie\_get\_customer`: Detalha um cliente/fornecedor \(ConsultarCliente\). Informe \`codigo\_cliente\_omie\` \(id Omie\) OU \`codigo\_cliente\_integracao\` \(sua chave de integração\).
- `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
- `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.
- `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\).
- `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.
- `omie\_list\_projects`: Lista os projetos da empresa \(ListarProjetos\). Paginado. Cada projeto tem um \`codigo\` que pode ser vinculado a um lançamento financeiro.
- `omie\_list\_document\_types`: Lista os tipos de documento \(dinheiro, boleto, cartão, transferência etc.\) — PesquisarTipoDocumento. Não é paginado. Cada tipo tem um \`codigo\` \(ex.: TRA = Transferência, BOL = Boleto\) usado em baixas e lançamentos de conta corrente. Passe \`codigo\` pra filtrar um específico.
- `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.
- `omie\_transfer\_between\_accounts`: TRANSFERE dinheiro entre DUAS contas correntes da própria empresa \(IncluirLancCC com bloco \`transferencia\`\). É a operação certa pra isso: a Omie gera os DOIS lados \(saída na origem, entrada no destino, origens TRAP/TRAR\) e eles ficam amarrados — não faça uma saída + uma entrada separadas pra simular
- `omie\_create\_checking\_account\_entry`: Cria um LANÇAMENTO avulso de conta corrente \(IncluirLancCC\): tarifa, rendimento, aplicação, resgate, ajuste. NÃO é conta a pagar/receber \(pra isso use omie\_lancar\) e NÃO é transferência \(use omie\_transfer\_between\_accounts\). \`data\` é um JSON string com os blocos da doc oficial: \`cabecalho\` \{nCodCC, d
- `omie\_update\_checking\_account\_entry`: Edita um lançamento de conta corrente \(AlterarLancCC\). \`data\` é um JSON string que DEVE conter a chave \(nCodLanc OU cCodIntLanc\) + os blocos a alterar \(cabecalho/detalhes\). Consulte antes com omie\_get\_checking\_account\_entry.
- `omie\_get\_checking\_account\_entry`: Detalha um lançamento de conta corrente \(ConsultaLancCC\). Informe nCodLanc \(id Omie\) OU cCodIntLanc.
- `omie\_list\_checking\_account\_entries`: Lista lançamentos de conta corrente \(ListarLancCC\). Paginado. \`filters\` \(JSON\) aceita cOrigem, dDtIncDe/dDtIncAte, dDtAltDe/dDtAltAte, dtPagInicial/dtPagFinal \(DD/MM/AAAA\). Transferências aparecem com origem TRAP \(saída\) e TRAR \(entrada\).
- `omie\_cancel\_payment`: CANCELA a baixa \(o pagamento\) de uma conta a pagar — CancelarPagamento. O título VOLTA a ficar em aberto; NÃO apaga o título \(pra isso é omie\_delete\_payable\). A chave é a BAIXA, não o lançamento: informe codigo\_baixa \(id Omie da baixa\) OU codigo\_baixa\_integracao \(a chave que você usou ao dar baixa\).
- `omie\_cancel\_receipt`: CANCELA a baixa \(o recebimento\) de uma conta a receber — CancelarRecebimento. O título volta a ficar em aberto; não apaga o título. Chave: codigo\_baixa OU codigo\_baixa\_integracao.
- `omie\_reconcile\_receipt`: Marca a baixa de um recebimento como CONCILIADA \(ConciliarRecebimento\). Use ao casar o extrato do banco com o título na Omie. Chave: codigo\_baixa OU codigo\_baixa\_integracao.
- `omie\_unreconcile\_receipt`: Desfaz a conciliação de uma baixa de recebimento \(DesconciliarRecebimento\). Chave: codigo\_baixa OU codigo\_baixa\_integracao.
- `omie\_upsert\_payables\_batch`: Cria OU atualiza VÁRIAS contas a pagar numa chamada \(UpsertContaPagarPorLote\). É o caminho pra mexer em massa \(trocar categoria, conta corrente etc.\) sem uma chamada por título. ⚠️ É UPSERT, não patch: o registro é gravado com o que você mandar, então inclua os campos que quer PRESERVAR, não só os q
- `omie\_upsert\_receivables\_batch`: Cria OU atualiza VÁRIAS contas a receber numa chamada \(UpsertContaReceberPorLote\). Mesmas regras do omie\_upsert\_payables\_batch: é UPSERT \(mande os campos a preservar\) e a chave de cada item é \`codigo\_lancamento\_integracao\`. \`data\`: \`\{"lote": 1, "conta\_receber\_cadastro": \[ \{…\} \]\}\`.
- `omie\_get\_invoice`: Detalhe COMPLETO de UMA nota fiscal \(ConsultarNF\). O omie\_list\_invoices devolve só o cabeçalho; este traz os ITENS com NCM, CFOP, valor, base de cálculo, alíquota e valor de cada tributo \(ICMS, ICMS-ST, PIS, COFINS, IPI, ISS, FCP, DIFAL\), os campos de IBS/CBS da Reforma e os totais. Identifique a no
- `omie\_get\_invoice\_xml`: XML da NF-e emitida \(ObterNfe, serviço dfedocs\). Devolve o documento fiscal em si — o mesmo XML autorizado pela SEFAZ — além da chave de acesso, do PDF do DANFE e do status. É o caminho para AUDITAR a nota: pegue o XML aqui e mande em auditor\_fiscal\_auditar\_nota. Identifique a nota por \`id\_nfe\`. Ele
- `omie\_upload\_attachment`: Anexa um arquivo \(comprovante, boleto, NF em PDF/PNG…\) a um documento da Omie — IncluirAnexo. É o par de omie\_lancar/omie\_settle\_payable: lançou ou deu baixa, anexa o comprovante sem abrir a tela web. - tabela: onde o documento vive \(ex.: "conta-pagar", "conta-receber"\). - id: o id do documento NAQU
- `omie\_list\_attachments`: Lista os anexos de um documento \(ListarAnexo\). Paginado. Devolve \`listaAnexos\` com o nIdAnexo de cada anexo — use em omie\_get\_attachment \(baixar\) ou omie\_delete\_attachment. Bulk support: accepts ids for batched execution.
- `omie\_get\_attachment`: Devolve o LINK DE DOWNLOAD de um anexo \(ObterAnexo\) — \`cLinkDownload\`, válido até \`dDtExpiracao\`. Identifique o anexo por id\_anexo \(veja omie\_list\_attachments\), codigo\_integracao ou file\_name. Bulk support: accepts ids for batched execution.
- `omie\_delete\_attachment`: Remove um anexo de um documento \(ExcluirAnexo\). IRREVERSÍVEL. Identifique por id\_anexo \(veja omie\_list\_attachments\), codigo\_integracao ou file\_name. Bulk support: accepts ids for batched execution.
- `omie\_settle\_payables\_batch`: Dá baixa em VÁRIAS contas a pagar numa chamada \(LancarPagamento por título, loop interno\). É o caminho pra conciliar um mês inteiro contra o extrato do banco sem uma chamada por título. Cada item de \`baixas\` identifica o título \(codigo\_lancamento = id Omie, igual ao codigo\_lancamento\_omie do get/lis
- `omie\_settle\_receivables\_batch`: Dá baixa em VÁRIAS contas a receber numa chamada \(LancarRecebimento por título, loop interno\). É o caminho pra conciliar um mês inteiro contra o extrato do banco sem uma chamada por título. Cada item de \`baixas\` identifica o título \(codigo\_lancamento = id Omie, igual ao codigo\_lancamento\_omie do get
- `omie\_list\_category\_types`: Lista os TIPOS de categoria da Omie \(ListarTipoCategoria\) — o \`tipo\_categoria\` \(cCodigo\) exigido ao criar ou alterar uma categoria. Cada tipo diz se é de gasto \(P\) ou receita \(R\).
- `omie\_get\_category`: Detalha uma categoria do plano de contas pelo código \(ConsultarCategoria\), ex.: "2.01.02".
- `omie\_create\_category`: Cria uma categoria no plano de contas \(IncluirCategoria\) ou um GRUPO totalizador \(IncluirGrupoCategoria\). Pra categoria: informe \`descricao\` + \`grupo\` \(nome OU código do grupo pai, que precisa ser totalizador, ex.: "2.01" ou "Despesas Administrativas"\). Pra grupo novo: \`descricao\` + \`tipo\_grupo\` \(R
- `omie\_update\_category`: Renomeia, ajusta ou INATIVA uma categoria do plano de contas \(AlterarCategoria / AlterarGrupoCategoria — a Omie não tem 'excluir categoria', inativar é o caminho\). Identifique por \`categoria\` \(código exato, ex. "2.01.02", ou nome\). \`inativar:true\` desativa; \`inativar:false\` reativa. Consulta antes p
- `omie\_cadastrar`: Atalho: cadastra um FORNECEDOR \(ou cliente\) na Omie a partir do CNPJ, preenchendo razão social, nome fantasia, endereço completo, e-mail e telefone da consulta cadastral pública \(Receita Federal\) — sem digitar nada. Se o CNPJ já estiver cadastrado, devolve o cadastro existente em vez de duplicar. Ca
- `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, conta corrente, projeto, departamentos\). Substitui o fluxo de 4-5 chamadas \(list\_customers + list\_categories + list\_checking\_accounts + create\). Aceita nome OU códi
- `show\_version`: Show the current MCP platform and adapter versions.
- `report\_bug`: Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.
- `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.
- `toolkit\_info`: Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.
- `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 \(ev
- `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

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html