> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nekt.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Omie as an MCP

> Let your AI agents use Omie in real time through the Nekt MCP Gateway.

Omie is a cloud-based ERP platform. By connecting it to Nekt, your AI agent can securely read your company's financial records, sales orders, clients, and inventory in real time to answer questions about your business.

| | Available |
| :- | :- |
| **Nekt Express** | Yes |
| **GCP** | Yes |
| **AWS** | Yes |

## Adding Omie as an MCP

Before you start, make sure the [MCP Server](/mcp-server/setup) is set up. See [MCPs](/mcps/overview) for how MCPs work.

1. Go to **Activate → [MCPs](https://app.nekt.ai/mcps)**, click **New MCP** and choose **Omie**.
2. **Name your MCP** and describe what it is used for. The agent reads the description to choose between MCPs of the same provider.
3. **Setup access**. To authenticate with Omie, you need your application keys:

   1. Log in to the Omie application.

   2. Go to your application settings and navigate to **Integrações** (Integrations) or **Resumo do App** (App Summary).

   3. Copy the keys for the company you want to connect. Each connection corresponds to one company.

   * **App Key**: App Key obtida no aplicativo Omie em Configurações > Integrações ou Resumo do App. Um par por empresa. (Required)
   * **App Secret**: App Secret obtido no aplicativo Omie em Configurações > Integrações ou Resumo do App. Mantido em segredo. (Required)
4. **Select tools**. Pick the tools your agents can use. See [Available tools](#available-tools) below.
5. Click **Save**. On Growth and Custom plans, choose who can use it; see [Access levels](/mcps/overview#access-levels).

## Example prompts

* "Can you pull our financial summary for today?"
* "Show me all accounts payable with a due date this week."
* "What were the most recent inventory movements?"
* "Look up the contact details and address for the client with CNPJ 12.345.678/0001-90."

## Available tools

Choose which of these tools your agents can use in **Select tools**.

<Note>
  **What changed in v1.1.** Added: `consultar_api`, `consultar_cliente`, `listar_categorias`, `listar_clientes`, `listar_contas_correntes`, `listar_contas_pagar`, `listar_contas_receber`, `listar_empresas`, `listar_extrato`, `listar_movimentos_estoque`, `listar_nfse`, `listar_notas_fiscais`, `listar_ordens_servico`, `listar_pedidos_venda`, `listar_produtos`, `obter_resumo_financas`, `pesquisar_titulos`. Removed: `omie_buscar_operacao`, `omie_descrever_operacao`, `omie_executar`, `omie_executar_em_varias`, `omie_listar_apps`.
</Note>

### Read tools

| Tool | Description | Parameters |
| :- | :- | :- |
| `consultar_api` | Consulta genérica de leitura para qualquer endpoint disponível na API Omie. Endpoint: POST /\<modulo\_servico>/ (Call: \<call>) Doc: [https://developer.omie.com.br/](https://developer.omie.com.br/) Por segurança, apenas chamadas de leitura são permitidas nesta versão. O nome da `call` deve iniciar obrigatoriamente… | `call` (string, required), `modulo_servico` (string, required), `param` (object\|array) |
| `consultar_cliente` | Consulta os dados detalhados de um cliente/fornecedor na Omie. Endpoint: POST /geral/clientes/ (Call: ConsultarCliente) Doc: [https://developer.omie.com.br/service-list/](https://developer.omie.com.br/service-list/) Requer ao menos um dos parâmetros: codigo\_cliente\_omie, codigo\_cliente\_integracao ou cnpj\_cpf. | `cnpj_cpf` (string), `codigo_cliente_omie` (integer), `codigo_cliente_integracao` (string) |
| `listar_categorias` | Lista o plano de contas / categorias financeiras cadastradas na Omie. Endpoint: POST /geral/categorias/ (Call: ListarCategorias) Doc: [https://developer.omie.com.br/service-list/](https://developer.omie.com.br/service-list/) Retorna `categoria_cadastro` com código, descrição e classificação contábil. | `pagina` (integer), `registros_por_pagina` (integer) |
| `listar_clientes` | Lista os clientes e fornecedores cadastrados na Omie. Endpoint: POST /geral/clientes/ (Call: ListarClientes) Doc: [https://developer.omie.com.br/service-list/](https://developer.omie.com.br/service-list/) Retorna `clientes_cadastro` com dados de contato, endereço, tags e paginação. Datas no formato dd/mm/aaaa. | `pagina` (integer), `filtrar_por_data_de` (string), `apenas_importado_api` (boolean), `filtrar_por_data_ate` (string), `registros_por_pagina` (integer) |
| `listar_contas_correntes` | Lista as contas correntes bancárias e caixas cadastradas na Omie. Endpoint: POST /geral/contacorrente/ (Call: ListarContasCorrentes) Doc: [https://developer.omie.com.br/service-list/](https://developer.omie.com.br/service-list/) Retorna `ListarContasCorrentes` com dados bancários, tipo de conta e saldo. | `pagina` (integer), `apenas_ativas` (boolean), `registros_por_pagina` (integer) |
| `listar_contas_pagar` | Lista os lançamentos de contas a pagar na Omie. Endpoint: POST /financas/contapagar/ (Call: ListarContasPagar) Doc: [https://developer.omie.com.br/service-list/](https://developer.omie.com.br/service-list/) Retorna `conta_pagar_cadastro` com título, fornecedor, vencimento, valor e status. | `pagina` (integer), `filtrar_por_status` (string), `filtrar_por_data_de` (string), `apenas_importado_api` (boolean), `filtrar_por_data_ate` (string), `registros_por_pagina` (integer) |
| `listar_contas_receber` | Lista os lançamentos de contas a receber na Omie. Endpoint: POST /financas/contareceber/ (Call: ListarContasReceber) Doc: [https://developer.omie.com.br/service-list/](https://developer.omie.com.br/service-list/) Retorna `conta_receber_cadastro` com título, cliente, vencimento, valor e status. | `pagina` (integer), `filtrar_por_status` (string), `filtrar_por_data_de` (string), `apenas_importado_api` (boolean), `filtrar_por_data_ate` (string), `registros_por_pagina` (integer) |
| `listar_empresas` | Lista as empresas cadastradas no Omie. Endpoint: POST /geral/empresas/ (Call: ListarEmpresas) Doc: [https://developer.omie.com.br/service-list/](https://developer.omie.com.br/service-list/) Retorna a lista de empresas (`empresas_cadastro`) com dados cadastrais e paginação. | `pagina` (integer), `apenas_ativas` (boolean), `registros_por_pagina` (integer) |
| `listar_extrato` | Lista o extrato de movimentações de uma conta corrente na Omie em um período. Endpoint: POST /financas/extrato/ (Call: ListarExtrato) Doc: [https://developer.omie.com.br/service-list/](https://developer.omie.com.br/service-list/) nCodCC: Código da conta corrente na Omie. dPeriodoInicial / dPeriodoFinal: datas no formato dd/m… | `nCodCC` (integer, required), `dPeriodoFinal` (string, required), `dPeriodoInicial` (string, required) |
| `listar_movimentos_estoque` | Lista as movimentações de estoque registradas na Omie. Endpoint: POST /estoque/consulta/ (Call: ListarMovimentoEstoque) Doc: [https://developer.omie.com.br/service-list/](https://developer.omie.com.br/service-list/) Retorna `movimentos` com produto, data, quantidade, tipo de movimento e valor. | `dDtDe` (string), `dDtAte` (string), `pagina` (integer), `registros_por_pagina` (integer) |
| `listar_nfse` | Lista as Notas Fiscais de Serviço Eletrônicas (NFS-e) emitidas na Omie. Endpoint: POST /servicos/nfse/ (Call: ListarNFSEs) Doc: [https://developer.omie.com.br/service-list/](https://developer.omie.com.br/service-list/) Retorna `nfseEncontradas` com número, tomador, valores e retenções. | `pagina` (integer), `dEmiFinal` (string), `dEmiInicial` (string), `registros_por_pagina` (integer) |
| `listar_notas_fiscais` | Lista as Notas Fiscais Eletrônicas (NF-e de produto) emitidas na Omie. Endpoint: POST /produtos/nfconsultar/ (Call: ListarNF) Doc: [https://developer.omie.com.br/service-list/](https://developer.omie.com.br/service-list/) Retorna `nfCadastro` com número, chave de acesso, destinatário, valor e status. | `pagina` (integer), `dEmiFinal` (string), `dEmiInicial` (string), `registros_por_pagina` (integer) |
| `listar_ordens_servico` | Lista as Ordens de Serviço cadastradas na Omie. Endpoint: POST /servicos/os/ (Call: ListarOS) Doc: [https://developer.omie.com.br/service-list/](https://developer.omie.com.br/service-list/) Retorna `osCadastro` com cabeçalho, serviços prestados, parcelas e status. | `pagina` (integer), `dDtIncDe` (string), `dDtIncAte` (string), `registros_por_pagina` (integer) |
| `listar_pedidos_venda` | Lista os pedidos de venda cadastrados na Omie. Endpoint: POST /produtos/pedido/ (Call: ListarPedidos) Doc: [https://developer.omie.com.br/service-list/](https://developer.omie.com.br/service-list/) Retorna `pedido_venda_produto` com cabeçalho, itens, parcelas e totais do pedido. | `pagina` (integer), `filtrar_por_etapa` (string), `filtrar_por_data_de` (string), `apenas_importado_api` (boolean), `filtrar_por_data_ate` (string), `registros_por_pagina` (integer) |
| `listar_produtos` | Lista os produtos cadastrados de forma resumida na Omie. Endpoint: POST /geral/produtos/ (Call: ListarProdutosResumido) Doc: [https://developer.omie.com.br/service-list/](https://developer.omie.com.br/service-list/) Retorna `produto_servico_resumido` com código, descrição, preços e estoque. | `pagina` (integer), `filtrar_por_data_de` (string), `apenas_importado_api` (boolean), `filtrar_por_data_ate` (string), `registros_por_pagina` (integer), `filtrar_apenas_omiepdv` (boolean) |
| `obter_resumo_financas` | Obtém o resumo financeiro da empresa em uma data específica ou na data atual. Endpoint: POST /financas/resumo/ (Call: ObterResumoFinancas) Doc: [https://developer.omie.com.br/service-list/](https://developer.omie.com.br/service-list/) Data no formato dd/mm/aaaa (dDia). | `dDia` (string) |
| `pesquisar_titulos` | Pesquisa títulos financeiros gerais (a receber e a pagar) na Omie. Endpoint: POST /financas/pesquisartitulos/ (Call: PesquisarLancamentos) Doc: [https://developer.omie.com.br/service-list/](https://developer.omie.com.br/service-list/) Datas em formato dd/mm/aaaa. | `dRegDe` (string), `pagina` (integer), `cStatus` (string), `dRegAte` (string), `dVencDe` (string), `dVencAte` (string), `registros_por_pagina` (integer) |

### Write tools

This connector has no write tools.

## Troubleshooting

If the MCP shows that it needs to reconnect, your API keys may have been rotated or revoked by an administrator. Generate a new App Key and App Secret in the Omie application settings, then sign in again from the MCP's page in Nekt.

## Need help?

Contact our support team if you have trouble connecting Omie.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.