Quaderno MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Quaderno MCP Server What's the VAT rate for digital services in Spain?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
The Problem
Tax compliance across borders is a nightmare. Different VAT rates per country, tax ID validation against government databases, reverse charge rules, digital services taxes... and your AI assistant can't help because it has no access to real-time tax data.
Related MCP server: Qonto MCP Server
The Solution
This MCP server gives any AI assistant (Claude, GPT, etc.) direct access to Quaderno's tax engine. Ask in plain English, get accurate, compliant answers.
You: "What tax should I charge for a SaaS sale to a customer in Spain?"
AI: IVA at 21% — status: taxable, currency: EURTools
Tool | What it does |
| Real-time tax rate calculation by country, postal code, and product type |
| Validate VAT/GST/ABN numbers against EU VIES, UK HMRC, and more |
| Create customers and companies with full billing details |
| Generate tax-compliant invoices with automatic tax calculation |
| Search and filter invoices by contact, status, or date |
Quick Start
1. Get your API key
Sign up at quaderno.io or create a free sandbox account for testing. Find your API key in Settings > API Keys.
2. Configure for Claude Desktop
Add to your config file:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"quaderno": {
"command": "node",
"args": ["/path/to/quaderno-mcp-server/dist/index.js"],
"env": {
"QUADERNO_API_KEY": "sk_live_your_key_here",
"QUADERNO_API_URL": "https://your-account.quadernoapp.com/api"
}
}
}
}For sandbox testing, use
https://your-account.sandbox-quadernoapp.com/api
Examples
Tax calculation
"What's the VAT rate for selling digital services in Spain?"
{
"country": "ES",
"name": "IVA",
"rate": 21.0,
"tax_code": "eservice",
"status": "taxable",
"currency": "EUR"
}Tax ID validation
"Is this Spanish tax ID valid? ESB86412491"
{
"valid": true
}Full invoicing flow
"Create a company contact for TechCorp in Madrid and invoice them 500 EUR for consulting"
The AI will chain create_contact → create_invoice automatically, producing a tax-compliant invoice with the correct Spanish IVA applied.
Supported Tax Jurisdictions
Quaderno supports real-time tax calculation for 200+ countries and tax ID validation for:
EU: All 27 member states (VAT via VIES)
United Kingdom: VAT via HMRC
Switzerland: UID
Australia: ABN/GST
New Zealand: GST
Canada: Quebec QST
Development
git clone https://github.com/AnderRahe/quaderno-mcp-server.git
cd quaderno-mcp-server
npm install
cp .env.example .env # Add your credentials
npm run buildTest with MCP Inspector
npx @modelcontextprotocol/inspector node ./dist/index.jsEnvironment Variables
Variable | Required | Description |
| Yes | Your Quaderno private API key |
| Yes | Full API base URL including |
Built With
Model Context Protocol SDK — Server framework
Quaderno API — Tax compliance engine
Zod — Schema validation
TypeScript + stdio transport
License
Available Tools
5 toolscalculate_taxCalculate TaxA
Calculate the applicable tax rate for a transaction based on customer location, product type, and optionally a tax ID. Returns the tax rate, tax name, and whether reverse charge applies.
Inputs: to_country (required), amount, tax_id, to_city, +2 more.
create_contactCreate ContactB
Create a new contact (customer or company) in Quaderno. The contact can later be referenced when creating invoices.
Inputs: kind (required), first_name (required), city, email, +9 more.
create_invoiceCreate InvoiceC
Create a tax-compliant invoice in Quaderno. You can reference an existing contact by ID or provide a contact name. Items include description, quantity, and unit price.
Inputs: items (required), notes, currency, tag_list, +4 more.
list_invoicesList InvoicesB
List invoices from your Quaderno account. Supports filtering by contact name, state, and date.
Inputs: q, date, page, state.
validate_tax_idValidate Tax IDB
Validate a tax identification number (VAT, GST, ABN, etc.). Supports EU VAT numbers, UK VAT, Switzerland, Australia, New Zealand, and Canada (Quebec).
Inputs: tax_id (required), country (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a distinct verb+resource focus: tax calculation, tax ID validation, contact creation, invoice creation, and invoice listing. No two tools overlap in triggering conditions.
All names use snake_case with a leading verb (calculate_, validate_, create_, list_) and are consistent in structure. There is no camelCase mixing or vague naming.
Five tools is well-scoped for a focused tax and invoicing integration. Each tool earns its place, and the set is not bloated or trivially thin.
Core create/list flows for invoices and contacts are present, but there is no get/update/delete for invoices or contacts, and no invoice retrieval by ID. These are notable lifecycle gaps that can block common correction or lookup workflows.
Maintenance
Related MCP Connectors
Validate EU, UK, AU VAT numbers for AI agents. EU ViDA e-invoicing compliance.
Create EU-compliant invoices, manage clients and download PDFs from your AI assistant.
Query your books, company data, business health, and ship invoices from your AI assistant.
Connect QuickBooks, Xero, Bill.com, Blackbaud and Stripe to ChatGPT, Claude, Grok and any AI app.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI assistants to query and manage QuickBooks Online data through natural language, including customers, invoices, bills, vendors, accounts, and financial reports.7MIT

Qonto MCP Serverofficial
AlicenseNot gradedqualityDmaintenanceEnables AI assistants to access Qonto financial data including organization info, account balances, transaction history, and business operations through natural language.42MIT- AlicenseNot gradedqualityDmaintenanceConnects AI assistants to QuickBooks Online, enabling management of invoices, customers, expenses, and reports through natural language.MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to manage business operations including invoicing, WooCommerce syncing, expense tracking, POS, inventory, and team management through natural language.2MIT