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-fiscal

Variá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  # compilar

Licença

MIT