MCP Nota Fiscal 🇧🇷
MCP Server para Nota Fiscal Eletrônica brasileira (NF-e, NFC-e, NFS-e).
Conecte seu assistente de IA ao sistema de notas fiscais do Brasil. Consulte CNPJs, emita notas, cancele, gere PDFs do DANFE — tudo via linguagem natural.
Powered by Nuvem Fiscal API.
Tools disponíveis
| Tool | Descrição | |------|-----------| | consultar_cnpj | Consulta dados públicos de CNPJ na Receita Federal | | status_sefaz | Verifica disponibilidade da Sefaz por UF | | listar_nfe | Lista NF-e emitidas por um CNPJ | | consultar_nfe | Detalhes de uma NF-e específica | | emitir_nfe | Emite uma nova NF-e | | cancelar_nfe | Cancela NF-e (até 24h) | | carta_correcao_nfe | Carta de Correção para NF-e | | baixar_pdf_nfe | Download do DANFE em PDF | | baixar_xml_nfe | Download do XML assinado | | inutilizar_nfe | Inutiliza faixa de numeração | | listar_nfse | Lista NFS-e emitidas | | consultar_nfse | Detalhes de uma NFS-e | | emitir_nfse | Emite uma nova NFS-e | | cancelar_nfse | Cancela NFS-e | | consultar_empresa | Dados da empresa na Nuvem Fiscal | | cadastrar_empresa | Cadastra empresa para emissão |
Setup
1. Obter token da Nuvem Fiscal
Crie uma conta em nuvemfiscal.com.br e gere um token de API.
2. Configurar no Claude Code
Adicione ao seu claude_desktop_config.json ou settings.json:
{
"mcpServers": {
"nota-fiscal": {
"command": "npx",
"args": ["-y", "@rodrigodocarmo/mcp-nota-fiscal"],
"env": {
"NUVEM_FISCAL_TOKEN": "seu-token-aqui",
"NUVEM_FISCAL_SANDBOX": "true"
}
}
}
}3. Usar via npm local
npm install @rodrigodocarmo/mcp-nota-fiscalVariáveis de ambiente
| Variável | Obrigatória | Descrição | |----------|-------------|-----------| | NUVEM_FISCAL_TOKEN | Sim | Token de acesso da API Nuvem Fiscal | | NUVEM_FISCAL_SANDBOX | Não | true (padrão) ou false para produção |
Exemplos de uso
"Consulta o CNPJ 00.000.000/0001-91"
"Lista as últimas 5 notas fiscais da minha empresa"
"Verifica se a Sefaz de SP está online"
"Cancela a nota fiscal X com justificativa Y"
Desenvolvimento
git clone https://github.com/rodrigo-do-carmo/mcp-nota-fiscal
cd mcp-nota-fiscal
npm install
npm run dev # watch mode
npm run build # compilarLicença
MIT
