Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@omie-mcp Liste as contas a pagar em aberto deste mês"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Servidor MCP (Model Context Protocol) para integração com o ERP OMIE. Permite controlar suas finanças diretamente pelo Claude (ou qualquer cliente MCP), usando linguagem natural.
Converse com o Claude e peça coisas como:
"Liste todas as contas a pagar em aberto do mês"
"Registre o pagamento da fatura do fornecedor X"
"Mostre o extrato bancário da conta corrente de março"
"Qual o fluxo de caixa previsto vs realizado em fevereiro?"
"Cadastre um novo fornecedor com CNPJ 12.345.678/0001-99"
"Crie uma categoria de despesa para 'Assinaturas de Software' ligada ao DRE"
"Qual o código do tipo de documento de boleto?"
Related MCP server: MCP Conta Azul
Módulo | Ferramentas |
Fornecedores | Listar, consultar, cadastrar e alterar fornecedores |
Contas a Pagar | Listar, consultar, incluir, lançar pagamento, cancelar e excluir |
Contas a Receber | Listar, consultar, incluir, lançar recebimento, cancelar e excluir |
Lançamentos Bancários | Listar, consultar, incluir e excluir transações em conta corrente |
Contas Correntes | Listar contas, consultar detalhes, extrato bancário por período e tipos de conta |
Fluxo de Caixa | Previsto vs realizado, resumo financeiro, títulos em aberto e pesquisa unificada |
Categorias | Listar, consultar, incluir e alterar categorias e grupos totalizadores |
Contas do DRE | Listar a estrutura do DRE e as contas vinculáveis a categorias |
Tipos de Documento | Pesquisar por descrição e consultar por código |
Bancos | Listar e consultar instituições financeiras e seus recursos de integração |
Total: 41 ferramentas MCP
Python 3.12+
uv instalado
Credenciais de API do OMIE (app_key e app_secret)
Para obter as credenciais, acesse no OMIE: Configurações → API → Aplicações
uvx direto do GitHub (sem instalar nada)uvx --from git+https://github.com/lucassampsouza/omie-mcp omie-mcpAs credenciais podem ser passadas por variáveis de ambiente ou por um arquivo .env:
# Via variáveis de ambiente
OMIE_APP_KEY=sua_key OMIE_APP_SECRET=seu_secret \
uvx --from git+https://github.com/lucassampsouza/omie-mcp omie-mcp# Via arquivo de configuração global (recomendado para uso contínuo)
mkdir -p ~/.config/omie-mcp
echo "OMIE_APP_KEY=sua_key" >> ~/.config/omie-mcp/.env
echo "OMIE_APP_SECRET=seu_secret" >> ~/.config/omie-mcp/.env
uvx --from git+https://github.com/lucassampsouza/omie-mcp omie-mcpuvgit clone https://github.com/lucassampsouza/omie-mcp
cd omie-mcp
# Configure as credenciais
cp .env.example .env
# Edite o .env com sua app_key e app_secret
uv run omie-mcpEdite o arquivo de configuração do Claude Desktop:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"omie": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/lucassampsouza/omie-mcp",
"omie-mcp"
],
"env": {
"OMIE_APP_KEY": "sua_app_key",
"OMIE_APP_SECRET": "seu_app_secret"
}
}
}
}Como o Python roda dentro do WSL, a forma mais confiável é usar um script wrapper que carrega as credenciais.
1. Configure as credenciais dentro do WSL:
mkdir -p ~/.config/omie-mcp
cat > ~/.config/omie-mcp/.env << EOF
OMIE_APP_KEY=sua_app_key
OMIE_APP_SECRET=seu_app_secret
EOF2. Crie o script wrapper em ~/omie-mcp-run.sh:
cat > ~/omie-mcp-run.sh << 'EOF'
#!/bin/bash
set -e
export $(grep -v '^#' ~/.config/omie-mcp/.env | xargs)
exec uvx --from git+https://github.com/lucassampsouza/omie-mcp omie-mcp
EOF
chmod +x ~/omie-mcp-run.sh3. Edite %APPDATA%\Claude\claude_desktop_config.json:
{
"mcpServers": {
"omie": {
"command": "wsl",
"args": ["/home/SEU_USUARIO/omie-mcp-run.sh"]
}
}
}Substitua
SEU_USUARIOpelo seu usuário no WSL (rodewhoamino terminal WSL para confirmar).
Ferramenta | Descrição |
| Lista fornecedores com filtros por nome ou CNPJ |
| Consulta detalhes de um fornecedor pelo código ou CNPJ |
| Cadastra um novo fornecedor |
| Atualiza dados de um fornecedor existente |
Ferramenta | Descrição |
| Lista contas filtrando por status, período e fornecedor |
| Consulta detalhes de uma conta específica |
| Cria uma nova conta a pagar |
| Registra o pagamento (baixa) de uma conta |
| Estorna o pagamento de uma conta |
| Exclui uma conta a pagar em aberto |
Ferramenta | Descrição |
| Lista contas filtrando por status, período e cliente |
| Consulta detalhes de uma conta específica |
| Cria uma nova conta a receber |
| Registra o recebimento (baixa) de uma conta |
| Estorna o recebimento de uma conta |
| Exclui uma conta a receber em aberto |
Ferramenta | Descrição |
| Lista transações de conta corrente por período |
| Consulta detalhes de um lançamento |
| Cria lançamento manual (débito ou crédito) |
| Exclui um lançamento bancário |
Ferramenta | Descrição |
| Lista todas as contas bancárias cadastradas no OMIE |
| Consulta detalhes de uma conta corrente específica |
| Extrato completo de uma conta em um período |
| Tipos aceitos no cadastro de conta corrente (CC, CP, CR, CX…) |
Ferramenta | Descrição |
| Previsto vs realizado por categoria em um mês |
| Resumo consolidado numa data de referência |
| Títulos não liquidados (a pagar ou a receber) |
| Pesquisa unificada (contas a pagar + a receber) |
Ferramenta | Descrição |
| Lista o plano de categorias, com filtros por tipo (R/D) e descrição |
| Consulta uma categoria pelo código, com a conta do DRE vinculada |
| Grupos totalizadores — os valores válidos para |
| Tipos de categoria — os valores válidos para |
| Cria uma categoria dentro de um grupo totalizador |
| Altera ou inativa uma categoria existente |
| Cria um grupo totalizador de receita ou despesa |
| Altera a descrição/natureza de um grupo |
Ferramenta | Descrição |
| Estrutura do DRE; com |
Ferramenta | Descrição |
| Pesquisa por descrição (ignora acentos e maiúsculas) |
| Consulta um tipo pelo código exato (BOL, NF, ADI…) |
Ferramenta | Descrição |
| Lista instituições financeiras, com filtro por nome e tipo |
| Detalhes de integração do banco (PIX, extrato, CNAB, boletos) |
As categorias são a espinha dorsal da classificação financeira, e o OMIE valida os vínculos na inclusão. A ordem que funciona é:
listar_grupos_categoria → escolhe categoria_superior (ex: 2.01)
listar_tipos_categoria → escolhe tipo_categoria com cTipo compatível
(grupo 1.xx → R, grupo 2.xx → P)
listar_contas_dre → escolhe codigo_dre entre as contas vinculáveis
(apenas_vinculaveis=True)
incluir_categoria → cria a categoria já classificada no DRECategorias, tipos de documento, bancos e tipos de conta corrente são justamente os códigos consumidos ao lançar contas a pagar, contas a receber e lançamentos bancários — consulte-os antes de criar um lançamento em vez de adivinhar códigos.
Somente leitura: a API do OMIE não expõe inclusão, alteração nem exclusão para contas do DRE, tipos de documento, bancos e tipos de conta corrente — essas tabelas são mantidas pelo ERP. Categoria também não tem exclusão: use
alterar_categoriacominativar=True.
Consumo redundante: o OMIE bloqueia por ~40 segundos a repetição de uma chamada idêntica (mesmo método e mesmos parâmetros), respondendo
Consumo redundante detectado. Varie os filtros ou aguarde a janela.
omie-mcp/
├── src/omie_mcp/
│ ├── client.py # Cliente HTTP para a API do OMIE
│ ├── server.py # Servidor MCP (FastMCP)
│ └── tools/
│ ├── fornecedores.py
│ ├── contas_pagar.py
│ ├── contas_receber.py
│ ├── lancamentos_cc.py
│ ├── contas_correntes.py
│ ├── fluxo_caixa.py
│ ├── categorias.py
│ ├── dre.py
│ ├── tipos_documento.py
│ └── bancos.py
├── .env.example # Modelo de variáveis de ambiente
├── pyproject.toml
└── README.mdMIT — veja o arquivo LICENSE para detalhes.
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Financial & accounting management on Omie (Brazil's leading cloud ERP), payables/receivables, financ
AI-native ERP MCP: ES/EU fiscal compliance (VeriFactu/TicketBAI/Facturae), invoicing, tax, banking
Financial management on Procfy — transactions (revenue/expense/transfers), bank accounts, contacts,
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/lucassampsouza/omie-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server