Skip to main content
Glama
Quaderno MCP Server

Quaderno MCP Server

by AnderRahe

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: EUR

Tools

Tool

What it does

calculate_tax

Real-time tax rate calculation by country, postal code, and product type

validate_tax_id

Validate VAT/GST/ABN numbers against EU VIES, UK HMRC, and more

create_contact

Create customers and companies with full billing details

create_invoice

Generate tax-compliant invoices with automatic tax calculation

list_invoices

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.json

  • Windows: %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 build

Test with MCP Inspector

npx @modelcontextprotocol/inspector node ./dist/index.js

Environment Variables

Variable

Required

Description

QUADERNO_API_KEY

Yes

Your Quaderno private API key

QUADERNO_API_URL

Yes

Full API base URL including /api

Built With

License

MIT

Available Tools

5 tools
calculate_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

    A3.5/5.0

    Scored across 5 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness3/5

    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

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables AI assistants to query and manage QuickBooks Online data through natural language, including customers, invoices, bills, vendors, accounts, and financial reports.
      7
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to access Qonto financial data including organization info, account balances, transaction history, and business operations through natural language.
      42
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Connects AI assistants to QuickBooks Online, enabling management of invoices, customers, expenses, and reports through natural language.
      MIT