# Quaderno MCP by usefulapi

> Quaderno MCP by usefulapi is an MCP server. MCP server for Quaderno — tax-rate calculation, invoices, contacts, products, receipts & expenses. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/quaderno/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/quaderno
- **MCP Registry name:** io.usefulapi/quaderno
- **Listing updated:** 2026-11-13

## About

MCP server for Quaderno — tax-rate calculation, invoices, contacts, products, receipts & expenses.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http quaderno https://quaderno.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://quaderno.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "quaderno": {
      "url": "https://quaderno.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "quaderno": {
      "type": "http",
      "url": "https://quaderno.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "quaderno": {
      "serverUrl": "https://quaderno.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "quaderno": {
      "type": "http",
      "url": "https://quaderno.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `quaderno_ping`: Verify the API key and connection by pinging Quaderno. Returns account/authentication status. Quaderno API: GET /ping.
- `quaderno_calculate_tax`: Calculate the correct tax rate/amount for a sale given the customer's location and product. This is Quaderno's flagship endpoint — it applies the right VAT / GST / US sales-tax rules per jurisdiction. READ-ONLY (no record is created). Quaderno API: GET /tax_rates/calculate. Returns { name, rate, country, region, county, city, tax_code, status (taxable|non_taxable|not_registered|reverse_charge), ta
- `quaderno_list_invoices`: List invoices, newest first, with optional filters. Quaderno API: GET /invoices. Returns invoice objects (id, number, issue_date, due_date, currency, contact, items, taxes, payments, state, total_cents, subtotal_cents), wrapped as { data, pagination } when more pages exist.
- `quaderno_get_invoice`: Fetch a single invoice by id (full object incl. items, taxes, payments, permalink, pdf). Quaderno API: GET /invoices/{id}.
- `quaderno_list_contacts`: List contacts (customers/vendors), newest first. Quaderno API: GET /contacts. Returns contact objects (id, kind, first_name, last_name, contact_name, email, country, tax_id, tax_status, …), wrapped as { data, pagination } when more pages exist.
- `quaderno_get_contact`: Fetch a single contact by id. Quaderno API: GET /contacts/{id}.
- `quaderno_list_items`: List products/items in the catalog, newest first. Quaderno API: GET /items. Returns item objects (id, code, name, kind, product_type, unit_cost, tax_class, tax_type, currency, stock, …), wrapped as { data, pagination } when more pages exist.
- `quaderno_get_item`: Fetch a single product/item by id. Quaderno API: GET /items/{id}.
- `quaderno_list_credit_notes`: List credit notes (refund documents), newest first. Quaderno API: GET /credit_notes. Wrapped as { data, pagination } when more pages exist.
- `quaderno_get_credit_note`: Fetch a single credit note by id. Quaderno API: GET /credit_notes/{id}.
- `quaderno_list_receipts`: List receipts, newest first. Quaderno API: GET /receipts. Wrapped as { data, pagination } when more pages exist.
- `quaderno_get_receipt`: Fetch a single receipt by id. Quaderno API: GET /receipts/{id}.
- `quaderno_list_expenses`: List expenses (bills you received), newest first. Quaderno API: GET /expenses. Wrapped as { data, pagination } when more pages exist.
- `quaderno_get_expense`: Fetch a single expense by id. Quaderno API: GET /expenses/{id}.
- `quaderno_list_tax_codes`: List the product tax codes Quaderno supports (id, name, description) — used as the tax_code on products / tax calculations. Quaderno API: GET /tax_codes.
- `quaderno_list_jurisdictions`: List the tax jurisdictions (id, name, country, region) where the account is registered to collect tax. Quaderno API: GET /jurisdictions.
- `quaderno_list_webhooks`: List the account's configured webhooks (id, url, events). Quaderno API: GET /webhooks.
- `quaderno_request`: Power-user escape hatch: GET any Quaderno API path not wrapped by a dedicated tool. READ-ONLY — only GET is allowed. Path is taken after /api (e.g. "/tax_ids", "/evidence"). Quaderno API: GET {path}.
- `quaderno_create_contact`: MUTATES Quaderno data — create a contact (customer or vendor). Provide kind plus a name; use `fields` for any other Quaderno contact attribute (phone_1, region, postal_code, city, street_line_1/2, tax_status, language, discount, notes, processor/processor_id). Quaderno API: POST /contacts. Returns the created contact.
- `quaderno_update_contact`: MUTATES Quaderno data — update an existing contact. Only the fields you pass are changed; use `fields` for any attribute not typed here. Quaderno API: PUT /contacts/{id}. Returns the updated contact.
- `quaderno_create_item`: MUTATES Quaderno data — create a product/item in the catalog. Provide name + unit_cost; use `fields` for any other attribute (code, description, tax_class, tax_type, currency, country, stock). Quaderno API: POST /items. Returns the created item.
- `quaderno_create_invoice`: MUTATES Quaderno data — create an invoice for a contact. Provide contact_id (or a contact via `fields`) and items; use `fields` for any other attribute (currency, issue_date, due_date, po_number, notes, tag_list, custom_metadata, payment_details). Each item = { description, quantity, unit_price, tax_1_name?, tax_1_rate?, discount_rate?, … }. Quaderno API: POST /invoices. Returns the created invoic
- `quaderno_create_transaction`: MUTATES Quaderno data — record a sale or refund transaction (Quaderno computes tax and produces the compliant document). Provide the customer, items, and payment. Use `fields` for any other attribute (date, currency, shipping_address, evidence, processor, processor_id, processor_fee_cents, exchange_rate, po_number, notes, tags, custom_metadata). Quaderno API: POST /transactions. Returns the create

## FAQ

### How do I add Quaderno MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http quaderno https://quaderno.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/quaderno-mcp-by-usefulapi
