Command Palette

Search for a command to run...

UnylyUnyly
Browse all

Nota Fiscal

FreeNot checked

Enables AI assistants to interact with Brazilian electronic invoices (NF-e, NFC-e, NFS-e) via Nuvem Fiscal API, including CNPJ lookup, invoice issuance, cancell

GitHubEmbed

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

from github.com/rodrigo-do-carmo/mcp-nota-fiscal

Install Nota Fiscal in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE
unyly install mcp-nota-fiscal

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

FAQ

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

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