odoo-verifactu-mcp
Provides read-only tools for Spanish tax compliance inside Odoo: compliance overview of installed Spanish localization modules (VeriFactu and SII, both Odoo S.A. and OCA), AEAT certificate status and expiry, customer invoice VeriFactu states with AEAT CSV and errors, SII issued/received invoice states, detailed per-invoice AEAT submissions and QR/CSV/chain data, aggregated AEAT error groups, and quarterly output/input VAT summaries by tax to help check form 303.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
odoo-verifactu-mcp
MCP server for Spanish tax compliance in Odoo. Ask Claude (or any MCP client) which invoices the AEAT rejected and why, which ones are still pending, when your certificate expires, or how much output and input VAT the quarter has.
Veri*Factu and SII in one place, per invoice and per period.
Odoo's own modules and the OCA ones.
l10n_es_edi_verifactuandl10n_es_edi_sii(Odoo S.A.), orl10n_es_verifactu_ocaandl10n_es_aeat_sii_oca(OCA l10n-spain). The server detects which ones you have and gives the same answers either way.Odoo 16 to 20. JSON-2 API on Odoo 19 and later, JSON-RPC on older versions.
Read-only. It never sends, cancels or changes anything at the AEAT or in Odoo.
Maintained by Francodesystems, Odoo implementation and integrations in Spain. Background on the Veri*Factu dates and who is affected: francodesystems.com/verifactu.
Tools
Tool | What it answers |
| Which Spanish modules are installed, how each company is set up (test or production), the AEAT certificates and days left, and how many invoices of the period are pending, accepted, accepted with errors, rejected or cancelled. Start here. |
| Customer invoices with their Veri*Factu state, AEAT CSV and last error. Filter by state, dates, company and customer. |
| The AEAT errors of the period grouped by message, with how many invoices have each one and some invoice numbers. |
| Issued and received invoices with their SII state, CSV and last error. |
| One invoice: state, QR URL, CSV, chain index or hash, every submission with its error, the invoice it substitutes, and its SII responses. |
| Output VAT (repercutido) and input VAT (soportado) by tax, with bases, including exempt and 0 % taxes. A working aid to check form 303; not the official form. |
Dates default to the current quarter (Europe/Madrid).
Normalized states
Odoo S.A. and the OCA name states differently. The tools always return these:
Veri*Factu | Odoo S.A. | OCA ( |
| no state yet, Veri*Factu required |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
SII: pending, accepted, accepted_with_errors, modified_not_sent (OCA only: changed after it was sent) and cancelled.
Related MCP server: mcp-facturacion-electronica-es
Setup
In Odoo, open your user → Preferences → Account Security → New API Key. Use a user with read access to Accounting.
Add the server to your MCP client. Claude Desktop (
claude_desktop_config.json):
{
"mcpServers": {
"odoo-verifactu": {
"command": "npx",
"args": ["-y", "@francodesystems-npm/odoo-verifactu-mcp"],
"env": {
"ODOO_URL": "https://mycompany.odoo.com",
"ODOO_API_KEY": "your-api-key"
}
}
}
}Claude Code:
claude mcp add odoo-verifactu -e ODOO_URL=https://mycompany.odoo.com -e ODOO_API_KEY=your-api-key -- npx -y @francodesystems-npm/odoo-verifactu-mcpVariable | Required | Notes |
| yes | Base URL of your Odoo. |
| yes | API key (a password also works on JSON-RPC). |
| sometimes | When the server hosts several databases, and always on Odoo 16-18. |
| Odoo 16-18 | The user's login. Leave it unset on Odoo 19+ to use JSON-2. |
| no |
|
Example questions
"¿Qué facturas ha rechazado la AEAT este trimestre y por qué?"
"Which invoices are still pending to send to Veri*Factu?"
"Show me everything about INV/2026/00123 at the AEAT."
"When does our SII certificate expire?"
"Give me output and input VAT for Q3 by tax."
How it was tested
Odoo 20 with
l10n_es_edi_verifactuandl10n_es_edi_sii(Odoo S.A.): every tool through a real MCP client, over JSON-2 and JSON-RPC (scripts/smoke.mjs). The VAT summary was checked to the cent against the journal items.Odoo 18 with the OCA modules (
l10n_es_verifactu_ocaandl10n_es_aeat_sii_ocafrom l10n-spain 18.0): every tool over JSON-RPC, with one company on Veri*Factu and one on SII and invoices in everyaeat_state.Unit tests for the OCA state mapping (
npm test).
The invoices were set to each state directly in test databases. Nothing was sent to the AEAT.
Development
npm install
npm run build
npm test
ODOO_URL=... ODOO_API_KEY=... ODOO_DB=... node scripts/smoke.mjsEn castellano
Servidor MCP para el cumplimiento fiscal español en Odoo. Le preguntas a Claude qué facturas ha rechazado la AEAT y por qué, cuáles faltan por enviar a Veri*Factu o al SII, cuándo caduca el certificado o cuánto IVA repercutido y soportado tiene el trimestre.
Funciona con los módulos de Odoo S.A. y con los de la OCA, de Odoo 16 a 20, y solo lee: no envía, no anula y no cambia nada. Para configurarlo basta con la URL de tu Odoo y una clave de API (Preferencias → Seguridad de la cuenta → Nueva clave de API).
Lo mantiene Francodesystems, implantación de Odoo e integraciones. Fechas y obligados de Veri*Factu: francodesystems.com/verifactu.
License
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Read-only access to Andorran accounting and tax data in Tributs: invoices, bank, IGI filings.
Audit VERI*FACTU hash chains, build the AEAT tax QR, build and validate Facturae 3.2.2 invoices.
Read-only EU e-invoice checks: VAT format, VIES, Peppol lookup. Returns evidence, no filing.
Validate, fix and generate Romanian e-Factura; check SAF-T D406 (ANAF validator + consistency)
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides access to official Spanish fiscal data and tools based on AEAT and BOE sources, covering income tax, VAT, and regional deductions. It enables AI assistants to answer tax-related queries and verify filing deadlines using verified information.1032 npm13MIT
- AlicenseAqualityBmaintenanceModel Context Protocol (MCP) server for Spanish Electronic Invoicing. Provides tools to generate, validate, and submit invoices across VERI\*FACTU, Facturae/FACe, SII, TicketBAI, and Crea y Crece B2B.20169 PyPI3Apache 2.0
- AlicenseNot gradedqualityDmaintenanceAllows consultation of NFS-e (electronic service invoices) from the Brazilian Federal Revenue official source, with a single read-only tool.MIT
- AlicenseCqualityDmaintenanceEnables read-only auditing of product, lot, location, and stock-movement history in Tryton 6.x, transforming natural-language questions into structured investigations with movement states, lots, shipments, locations, and diagnostic balances.231Apache 2.0