Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

Facturas Inbox MCP

de pedrozapatadevversión 0.1.0i★ 0iSe ejecuta en tu computadoraRepositorio ↗
Nombre en el registroio.github.pedrozapatadev/facturas-inbox-mcp

Cómo instalar

What it does

Spanish invoice PDFs to validated data: NIF/IVA/IRPF extraction, arithmetic checks, IVA per quarter.

  • Connects Se ejecuta en tu computadora
  • Account or key No key needed
  • Category Chat y correo

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad0/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad7/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo0/8El endpoint en la nube respondió en la última revisión
Puntuación de uso7/100

Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala Facturas Inbox MCP. Sigue https://mcp.popnx.com/i/pedrozapatadev-facturas-inbox-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

Que la IA lo instale

Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Facturas Inbox MCP para Claude en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "facturas-inbox": { "command": "npx", "args": [ "-y", "facturas-inbox-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Facturas Inbox MCP aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Abre el archivo de configuración de la app de Claude de escritorio

    SettingsDeveloperEdit Config

  3. Pega esta configuración y guarda el archivo

    {
      "mcpServers": {
        "facturas-inbox": {
          "command": "npx",
          "args": [
            "-y",
            "facturas-inbox-mcp"
          ]
        }
      }
    }
  4. Cierra Claude y vuelve a abrirlo

  5. Pruébalo

    Usa Facturas Inbox MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando Facturas Inbox MCP o muestra una herramienta de Facturas Inbox MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar Facturas Inbox MCP

Facturas Inbox MCP se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar Facturas Inbox MCP

  • Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
  • Instala Node.js en tu computadora primero (una sola vez)
  • Instala Node.js en tu computadora primero (una sola vez) · No hay botón de un clic: pega la configuración y completa los valores tú
  • Instala Node.js en tu computadora primero (una sola vez) · No hay botón de un clic: pega la configuración y completa los valores tú

B · Otros en Chat y correo que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Facturas Inbox MCP para Claude Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user facturas-inbox -- npx -y facturas-inbox-mcp 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Facturas Inbox MCP aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  3. Pega este comando y pulsa Enter

    claude mcp add --scope user facturas-inbox -- npx -y facturas-inbox-mcp
  4. Escribe /mcp en Claude Code

    Deberías ver Facturas Inbox MCP en la lista como conectado

  5. Pruébalo

    Usa Facturas Inbox MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando Facturas Inbox MCP o muestra una herramienta de Facturas Inbox MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez) · No hay botón de un clic: pega la configuración y completa los valores tú

Que la IA lo instale

Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Facturas Inbox MCP para Cursor en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "facturas-inbox": { "command": "npx", "args": [ "-y", "facturas-inbox-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Facturas Inbox MCP aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Abre el archivo de configuración MCP de Cursor

    ~/.cursor/mcp.json

    Pega esta configuración, completa los valores vacíos y guarda

    {
      "mcpServers": {
        "facturas-inbox": {
          "command": "npx",
          "args": [
            "-y",
            "facturas-inbox-mcp"
          ]
        }
      }
    }
  3. Abre el chat de IA de Cursor en modo Agent

  4. Pruébalo

    Usa Facturas Inbox MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando Facturas Inbox MCP o muestra una herramienta de Facturas Inbox MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

Instala Node.js en tu computadora primero (una sola vez) · No hay botón de un clic: pega la configuración y completa los valores tú

Que la IA lo instale

Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server Facturas Inbox MCP para VS Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "facturas-inbox": { "type": "stdio", "command": "npx", "args": [ "-y", "facturas-inbox-mcp" ] } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de Facturas Inbox MCP aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Abre el archivo de configuración MCP de VS Code

    MCP: Open User Configuration

    Pega esta configuración, completa los valores vacíos y guarda

    {
      "servers": {
        "facturas-inbox": {
          "type": "stdio",
          "command": "npx",
          "args": [
            "-y",
            "facturas-inbox-mcp"
          ]
        }
      }
    }
  3. Abre el chat de IA de VS Code en modo Agent

  4. Pruébalo

    Usa Facturas Inbox MCP y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando Facturas Inbox MCP o muestra una herramienta de Facturas Inbox MCP en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa Facturas Inbox MCP💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

claude mcp add --scope user facturas-inbox -- npx -y facturas-inbox-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "facturas-inbox": {
      "command": "npx",
      "args": [
        "-y",
        "facturas-inbox-mcp"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "facturas-inbox": {
      "command": "npx",
      "args": [
        "-y",
        "facturas-inbox-mcp"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "facturas-inbox": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "facturas-inbox-mcp"
      ]
    }
  }
}

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
44/sem
Conexión
Se ejecuta en tu computadora
Última versióni
0.1.0
Categoríai
Chat y correo
Publicado en el registroi
8 oct 2026
Último cambio de códigoi
8 oct 2026
Creador
pedrozapatadev
Paquetes
npm: facturas-inbox-mcp
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub pedrozapatadev, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hace 42 días

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • – No aplica

    El endpoint responde

    Este se ejecuta en tu computadora; no hay endpoint en internet

  • – No aplica

    Inicio de sesión con OAuth

    Se ejecuta en tu computadora y usa ajustes locales en su lugar

  • … Aún sin revisar

    Sin instrucciones ocultas en las descripciones de herramientas

    Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Vulnerabilidades publicadas (OSV.dev)

Sin entradas en OSV.dev para facturas-inbox-mcp@0.1.0

Solo revisa esta versión del paquete, no todas sus dependencias · revisado 16 nov 2026

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/pedrozapatadev-facturas-inbox-mcp.svg)](https://mcp.popnx.com/en/servers/pedrozapatadev-facturas-inbox-mcp)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Chat y correoi

  • Más estrellas que el 0% de los otros 2024 servidores de esta categoría
  • Publicado en el registro más recientemente que el 38% de los otros 2024 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 2024 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro Facturas Inbox MCP?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hace 42 días, y la última versión (0.1.0) llegó al registro hace 42 días.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: emailmd, Kite Discord Bot Builder, e2a — email for AI agents, Infobip MCP, kernelCAD

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

emailmd

Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.

de anypostMuy usado↓ 5,4 mil/sem★ 1,4 milActualizado hace 5 días

Computadora o nube✓ del servicio · emailmd.dev

Kite Discord Bot Builder

Build and fix Discord bots from a chat. Kite hosts them 24/7, with no code to deploy.

de merlinfuchsEn crecimiento★ 334 Estrellas de todo el repositorioActualizado hace 22 días

Se ejecuta en la nube✓ del servicio · kite.onl

e2a — email for AI agents

Authenticated email gateway for AI agents — per-agent inboxes, HITL approval, SPF/DKIM verified.

de tokencanopyEn crecimiento★ 200 Estrellas de todo el repositorioActualizado hace 4 meses

Se ejecuta en la nube✓ del servicio · e2a.dev

Infobip MCP

Infobip MCP server for omnichannel communication and messaging. SMS, RCS, WhatsApp, Viber and more.

de infobipInicial★ 36Actualizado hace 13 meses

Se ejecuta en la nube✓ del servicio · infobip.com

kernelCAD

CAD in ChatGPT and Claude: editable parts, STEP/STL/drawings, in-chat 3D, automatic checks.

de w1neInicial★ 35Actualizado hace 23 días

Se ejecuta en la nube✓ del servicio · kernelcad.com
Comparado con otros parecidos
Este
Facturas Inbox MCP
emailmdKite Discord Bot Buildere2a — email for AI agentsInfobip MCPkernelCAD
Dónde se ejecutaSe instala en tu equipoEn la nube o instalado en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveNoNoNoNoNoNo
Se añade con + en ClaudeNoNoNoNoSíNo
Revisiones básicas3/35/54/44/44/44/4
LicenciaMITMITAGPL-3.0Apache-2.0MITMIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

facturas-inbox-mcp

An MCP server that turns a folder of Spanish business documents into validated, structured data an AI agent can reason over. It classifies each PDF (factura, rectificativa, ticket, nómina, modelo AEAT…), extracts the invoice fields (NIF/CIF, base imponible, IVA per rate, IRPF, total), checks the arithmetic and the tax-ID checksums, and computes the IVA soportado / repercutido position for a quarter.

Local and offline. No API keys. It reads only the folders you give it.

Built for the everyday job of a Spanish *gestoría*: a client drops a month of PDFs in a folder and

someone has to work out what is what, what adds up and what the VAT position is.

30-second demo

Claude Code, Sonnet, pointed at the synthetic examples/inbox (11 documents, including a wrong total, a ticket, a credit note, a payslip, a modelo 303 and a scanned page). Real session; the answer is trimmed for length (full, unedited transcript in docs/demo-transcript.md):

> I'm the bookkeeper for Gestoría Demo Ficticia SL (CIF B87654323). Process the invoice

inbox and tell me our IVA position for Q3 2026, and flag anything I need to look at by hand. Answer in English, briefly.

⏺ facturas - scan_folder {} ⏺ facturas - vat_summary {"own_tax_id":"B87654323","quarter":"2026-Q3"} ⏺ facturas - validate_tax_id {"tax_id":"B87654323"}

Q3 2026 IVA position: €243.00 to pay (a pagar), provisional.

  • IVA repercutido: €504.00, from 1 issued invoice (GD-2026-0088, base €2,400 at 21%)
  • IVA soportado: €261.00, from 4 received documents (base €1,400): €231 at 21% and €30 at 10%
  • The July papelería invoice (€52.50 IVA) is cancelled out by the September credit note.

Check by hand:

  1. Papelería PE-2026/0455 (30 Jul): the total says €1,250 but base + IVA comes to €1,210. Excluded. If the supplier corrects it, your position drops to about €33.
  2. Gasolinera ticket 88213 (14 Aug, €60): IVA not broken out and no recipient NIF. Excluded. Probably not deductible without a full invoice.
  3. Scanned PDF (5 Sep): no text layer, so it needs OCR or a manual read. It could be a missing Q3 invoice.
  4. Credit note PE-2026/R-0019: classified at 0.69 confidence. Confirm it really is a rectificativa of PE-2026/0412.
  5. Laura's advisory invoice (3 Aug): €150 IRPF withheld, which goes on modelo 111, not the IVA return. …

5 turns · 23 s · $0.13. Every number comes from a tool result, not from the model doing arithmetic. Documents that fail a check are excluded and listed with a reason, so nothing is silently counted or silently dropped.

Tools

ToolWhat it doesHints
scan_folderClassify and extract every document in a folder; one compact row each, paginated with limit / cursorread-only
classify_documentLabel one document, with a confidence score and the signals behind the labelread-only
extract_invoiceInvoice number, date, issuer/recipient NIF, base, VAT lines, IRPF, total, plus every cross-check. `response_format: concise \detailed`read-only
validate_tax_idNIF / NIE / CIF checksum validation. Says the expected control character when wrongread-only
vat_summaryIVA repercutido vs. soportado for a quarter (2026-Q3) or a from/to range, by rate, with the exclusions listedread-only
export_csvWrite the scan to a new .csv file (;-separated, decimal comma, opens directly in Spanish Excel). Never overwriteswrites a new file

Every tool publishes an outputSchema and returns structuredContent, and the SDK validates both directions. All tools set full annotations (readOnlyHint, destructiveHint: false, idempotentHint, openWorldHint: false), so clients can auto-approve the read-only ones.

The checks

extract_invoice returns status: "ok" only when every check passes:

CheckRule
issuer_tax_idA checksum-valid NIF/NIE/CIF is present before the client section
issue_dateA real calendar date was found (15/07/2026, 22 de septiembre de 2026, …)
vat_rate_standardEvery VAT rate is a Spanish rate (0, 4, 5, 10, 21 %)
vat_mathbase × rate = VAT, per rate when the invoice breaks bases out (±1 cent)
irpf_mathbase × IRPF rate = withholding (±1 cent)
total_mathbase + VAT − IRPF = total

All arithmetic is in integer cents.

Install

Requires Node.js 20.12 or newer.

Try it in 30 seconds (bundled sample data)
claude mcp add facturas-demo -- npx -y facturas-inbox-mcp --demo

--demo serves the synthetic inbox that ships with the package. Then ask Claude: *"I'm the bookkeeper for CIF B87654323. What's our IVA position for Q3 2026, and what should I check by hand?"*

Claude Code
claude mcp add facturas -- npx -y facturas-inbox-mcp ~/Documents/facturas
Claude Desktop

Add this to claude_desktop_config.json (Settings → Developer → Edit Config):

{

"mcpServers": { "facturas": { "command": "npx", "args": ["-y", "facturas-inbox-mcp", "/Users/you/Documents/facturas"] } } }

Any other MCP client

It's a standard stdio server: npx -y facturas-inbox-mcp [more folders…], or npx -y facturas-inbox-mcp --demo. Folders can also come from FACTURAS_INBOX_DIRS (separated like PATH).

From source, with the sample inbox
git clone https://github.com/pedrozapatadev/facturas-inbox-mcp && cd facturas-inbox-mcp

npm install && npm run build claude mcp add facturas -- node "$PWD/dist/index.js" "$PWD/examples/inbox"

Then ask: *"I'm the bookkeeper for CIF B87654323. What's our IVA position for Q3 2026?"*

To poke at the tools without an LLM, run npm run inspect (MCP Inspector).

Design decisions

  • Deterministic core, no model inside. The agent is already a language model. What it lacks are tools whose answers it can trust. Extraction is rule-based and every result carries its evidence: classifier signals, check details, warnings. The server can explain itself, and the same input always gives the same output.
  • Fail loudly, not silently. Fields that weren't found are null, not guessed. Documents that fail a check are excluded from totals *and listed with the reason*. Errors are returned as isError results that say how to fix the call ("Pass force: true to try anyway", "Run OCR first").
  • Token-efficient. scan_folder returns compact rows and paginates. extract_invoice is concise by default. export_csv returns a path and counts, not the data.
  • Sandboxed filesystem. Paths are resolved with realpath and must sit inside a folder given at startup, so ../ traversal and symlinks that point outside are rejected (and tested). The only write is export_csv, which creates new .csv files and never overwrites.
  • Untrusted document text. The server instructions tell the agent never to follow instructions found inside a document. Raw text is only returned on request, labelled untrusted_text_preview. CSV cells that start with =, +, - or @ are neutralized against spreadsheet formula injection. Exports are created 0600.
  • Bounded work per document. Files are limited to 20 MB and PDFs to 200 pages. Text is cut at 1M characters before analysis. The extraction regexes are linear-time; a ReDoS case has a regression test.
  • Threat model. The attacker controls document *contents*, not the filesystem. Paths that are missing and paths outside the folders get the same error, so the tool can't be used to probe what exists elsewhere. Someone who can already write to the inbox could race the check-then-read (a TOCTOU window); that is out of scope.
  • stdout is the protocol. All logging goes to stderr. An end-to-end test drives the built binary over real stdio, and it would fail on a stray console.log.

Limitations

Honest scope. This is a showcase-sized tool, not accounting software.

  • PDFs need a text layer. Scanned images are reported as unreadable with an OCR hint (e.g. ocrmypdf); there is no built-in OCR.
  • Heuristic extraction tuned to common Spanish invoice layouts (labelled fields like *Base imponible*, *IVA 21 %*, *Total factura*). Unusual layouts come back as needs_review rather than wrong.
  • Not handled yet: recargo de equivalencia, intra-EU / reverse-charge invoices, Facturae XML, and counterparty names (only tax IDs).
  • Checksum validation only. A valid NIF is well-formed; it is not confirmed as registered with AEAT or VIES.
  • Not an e-invoicing or VeriFactu tool. It reads received paperwork; it does not issue invoices or file returns. vat_summary is a working figure for review, not a modelo 303.

Development

npm install

npm run fixtures # regenerate examples/inbox (synthetic data, valid-checksum fictional IDs) npm run typecheck npm test # unit + in-memory MCP client + stdio end-to-end (build first for the e2e) npm run build npm run inspect # MCP Inspector UI against the sample inbox

src/ index.ts stdio entry point, CLI args → allowed folders server.ts the six tools: schemas, annotations, error mapping schemas.ts zod input/output schemas pipeline.ts read → classify → extract, shared by all tools classify.ts rule-based document classifier with explainable signals extract.ts invoice field extraction + arithmetic checks taxid.ts NIF / NIE / CIF validation amounts.ts Spanish amounts and dates, in integer cents vat-summary.ts repercutido / soportado aggregation documents.ts sandboxed filesystem + PDF text extraction csv.ts Excel-friendly CSV export test/ MCP-level tests (in-memory client, stdio e2e, sandbox escapes)

Built on the official MCP TypeScript SDK v2 (@modelcontextprotocol/server), zod and unpdf.

Releasing
  1. Bump version in package.json and both version fields in server.json.
  2. npm publish (runs build + tests first; needs npm 2FA).
  3. gh workflow run publish-mcp-registry.yml lists the new version in the MCP Registry via GitHub OIDC (no secrets).

Roadmap

  • Optional OCR pass for scanned documents
  • Counterparty names, recargo de equivalencia, intra-EU invoices
  • Facturae XML input
  • VIES lookup as an opt-in, clearly network-marked tool
  • Streamable HTTP transport for remote deployment

License

MIT © 2026 Pedro Zapata Medal. All sample documents are synthetic: the companies, people and tax IDs are fictional.