MCP server
Quaderno MCP by usefulapi
MCP server for Quaderno — tax-rate calculation, invoices, contacts, products, receipts &…
- Runs
- Remotely
- Version
- 1.41.0
- Listing updated
- 4 days ago
About Quaderno MCP by usefulapi
Quaderno MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
MCP server for Quaderno — tax-rate calculation, invoices, contacts, products, receipts & expenses.
Install
Run in a terminal
claude mcp add --transport http quaderno https://quaderno.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://quaderno.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"quaderno": {
"url": "https://quaderno.usefulapi.io/mcp"
}
}
}Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:
Add to .vscode/mcp.json
{
"servers": {
"quaderno": {
"type": "http",
"url": "https://quaderno.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"quaderno": {
"serverUrl": "https://quaderno.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"quaderno": {
"type": "http",
"url": "https://quaderno.usefulapi.io/mcp"
}
}
}Tools this server provides (23)
Read directly from the server.
- 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
Quaderno MCP by usefulapi 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