Nota Fiscal
FreeNot checkedEnables AI assistants to interact with Brazilian electronic invoices (NF-e, NFC-e, NFS-e) via Nuvem Fiscal API, including CNPJ lookup, invoice issuance, cancell
About
Enables AI assistants to interact with Brazilian electronic invoices (NF-e, NFC-e, NFS-e) via Nuvem Fiscal API, including CNPJ lookup, invoice issuance, cancellation, and PDF generation.
README
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
Install Nota Fiscal in Claude Desktop, Claude Code & Cursor
unyly install mcp-nota-fiscalInstalls into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.
First time? Get the CLI: curl -fsSL https://unyly.org/install | sh
Or configure manually
Run in your terminal:
claude mcp add mcp-nota-fiscal -- npx -y github:rodrigo-do-carmo/mcp-nota-fiscalFAQ
Is Nota Fiscal MCP free?
Yes, Nota Fiscal MCP is free — one-click install via Unyly at no cost.
Does Nota Fiscal need an API key?
No, Nota Fiscal runs without API keys or environment variables.
Is Nota Fiscal hosted or self-hosted?
A hosted option is available: Unyly runs the server in the cloud, no local setup required.
How do I install Nota Fiscal in Claude Desktop, Claude Code or Cursor?
Open Nota Fiscal on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.
Related MCPs
Stripe
Payments, customers, subscriptions
by Stripemalamutemayhem/unclick-agent-native-endpoints
110+ tools for AI agents spanning social media, finance, gaming, music, AU-specific services, and utilities. Zero-config local tools plus platform connectors. n
by malamutemayhemwhiteknightonhorse/APIbase
Unified API hub for AI agents with 56+ tools across travel (Amadeus, Sabre), prediction markets (Polymarket), crypto, and weather. Pay-per-call via x402 micropa
by whiteknightonhorsetrackerfitness729-jpg/sitelauncher-mcp-server
Deploy live HTTPS websites in seconds. Instant subdomains ($1 USDC) or custom .xyz domains ($10 USDC) on Base chain. Templates for crypto tokens and AI agent pr
Compare Nota Fiscal with
Not sure what to pick?
Find your stack in 60 seconds
Author?
Embed badge for your README
Browse similar
All finance MCPs
