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), tax_amount, subtotal, total_amount }.

read-only

Argument	Type	Description
date	string	Transaction date (YYYY-MM-DD); defaults to today.
amount	number	Transaction amount to compute the tax on.
tax_id	string	The customer's tax ID / VAT number (may trigger reverse-charge).
to_city	string	The customer's city (recommended for US sales tax).
currency	string	ISO 4217 currency code (e.g. "USD").
tax_code	string	Product tax code, e.g. "standard", "reduced", "exempt", "eservice", "ebook", "saas", "consulting".
to_street	string	The customer's street address (recommended for US sales tax).
to_country*	string	The customer's country — 2-letter ISO code (e.g. "US", "DE"). Required.
from_country	string	The seller's country (2-letter ISO); defaults to the account country.
product_type	string	Whether the product is a good or a service.
tax_behavior	string	Whether the amount includes tax or not.
to_postal_code	string	The customer's ZIP / postal code (recommended for US sales tax).
from_postal_code	string	The seller's postal code.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "to_country"
  ],
  "properties": {
    "date": {
      "type": "string",
      "description": "Transaction date (YYYY-MM-DD); defaults to today."
    },
    "amount": {
      "type": "number",
      "description": "Transaction amount to compute the tax on."
    },
    "tax_id": {
      "type": "string",
      "description": "The customer's tax ID / VAT number (may trigger reverse-charge)."
    },
    "to_city": {
      "type": "string",
      "description": "The customer's city (recommended for US sales tax)."
    },
    "currency": {
      "type": "string",
      "description": "ISO 4217 currency code (e.g. \"USD\")."
    },
    "tax_code": {
      "type": "string",
      "description": "Product tax code, e.g. \"standard\", \"reduced\", \"exempt\", \"eservice\", \"ebook\", \"saas\", \"consulting\"."
    },
    "to_street": {
      "type": "string",
      "description": "The customer's street address (recommended for US sales tax)."
    },
    "to_country": {
      "type": "string",
      "description": "The customer's country — 2-letter ISO code (e.g. \"US\", \"DE\"). Required."
    },
    "from_country": {
      "type": "string",
      "description": "The seller's country (2-letter ISO); defaults to the account country."
    },
    "product_type": {
      "enum": [
        "good",
        "service"
      ],
      "type": "string",
      "description": "Whether the product is a good or a service."
    },
    "tax_behavior": {
      "enum": [
        "inclusive",
        "exclusive"
      ],
      "type": "string",
      "description": "Whether the amount includes tax or not."
    },
    "to_postal_code": {
      "type": "string",
      "description": "The customer's ZIP / postal code (recommended for US sales tax)."
    },
    "from_postal_code": {
      "type": "string",
      "description": "The seller's postal code."
    }
  }
}

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.

destructive

Argument	Type	Description
kind*	string	Contact kind.
email	string	Contact email address.
fields	object	Additional raw Quaderno fields merged into the request body (escape hatch for any field not typed above).
tax_id	string	The contact's tax ID / VAT number.
country	string	2-letter ISO country code.
last_name	string	The person's last name (persons only).
first_name	string	For a person: their first name. For a company: the company name (Quaderno stores it here).
contact_name	string	The contact person's name at a company (companies only).

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 invoice (incl. permalink, pdf).

destructive

Argument	Type	Description
items	array	Line items, e.g. [{ description, quantity, unit_price, tax_1_name, tax_1_rate }].
notes	string	Free-text notes on the invoice.
fields	object	Additional raw Quaderno fields merged into the request body (escape hatch for any field not typed above).
currency	string	ISO 4217 currency code.
due_date	string	Due date (YYYY-MM-DD).
po_number	string	Purchase-order number.
contact_id	string	The id of an existing contact to invoice. Omit only if you pass a full `contact` object via `fields`.
issue_date

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.

destructive

Argument	Type	Description
code	string	SKU / product code.
kind	string	Whether it is a one-off or a subscription product.
name*	string	Product name.
fields	object	Additional raw Quaderno fields merged into the request body (escape hatch for any field not typed above).
currency	string	ISO 4217 currency code.
unit_cost*	number	Unit price of the product.
product_type	string	Whether the product is a good or a service.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "name",
    "unit_cost"
  ],
  "properties": {
    "code": {
      "type": "string",
      "description": "SKU / product code."
    },
    "kind": {
      "enum": [
        "one_off",
        "subscription"
      ],
      "type": "string",
      "description": "Whether it is a one-off or a subscription product."
    },
    "name": {
      "type": "string",
      "description": "Product name."
    },
    "fields": {
      "type": "object",
      "description": "Additional raw Quaderno fields merged into the request body (escape hatch for any field not typed above).",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "currency": {
      "type": "string",
      "description": "ISO 4217 currency code."
    },
    "unit_cost": {
      "type": "number",
      "description": "Unit price of the product."
    },
    "product_type": {
      "enum": [
        "good",
        "service"
      ],
      "type": "string",
      "description": "Whether the product is a good or a service."
    }
  }
}

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 created invoice/credit-note object.

destructive

Argument	Type	Description
type	string	Transaction type (default "sale").
items*	array	Required. Transaction line items, e.g. [{ description, amount, quantity, tax_code, product_type }].
fields	object	Additional raw Quaderno fields merged into the request body (escape hatch for any field not typed above).
payment	object	Payment object, e.g. { payment_method, amount, date }.
currency	string	ISO 4217 currency code.
customer	object	The customer contact object (or reference), e.g. { first_name, last_name, email, country, tax_id }.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "items"
  ],
  "properties": {
    "type": {
      "enum": [
        "sale",
        "refund"
      ],
      "type": "string",
      "description": "Transaction type (default \"sale\")."
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "propertyNames": {
          "type": "string"
        },
        "additionalProperties": {}
      },
      "description": "Required. Transaction line items, e.g. [{ description, amount, quantity, tax_code, product_type }]."
    },
    "fields": {
      "type": "object",
      "description": "Additional raw Quaderno fields merged into the request body (escape hatch for any field not typed above).",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "payment": {
      "type": "object",
      "description": "Payment object, e.g. { payment_method, amount, date }.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "currency": {
      "type": "string",
      "description": "ISO 4217 currency code."
    },
    "customer": {
      "type": "object",
      "description": "The customer contact object (or reference), e.g. { first_name, last_name, email, country, tax_id }.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    }
  }
}

quaderno_get_contact

Fetch a single contact by id. Quaderno API: GET /contacts/{id}.

read-only

Argument	Type	Description
id*	string	The resource id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "The resource id."
    }
  }
}

quaderno_get_credit_note

Fetch a single credit note by id. Quaderno API: GET /credit_notes/{id}.

read-only

Argument	Type	Description
id*	string	The resource id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "The resource id."
    }
  }
}

quaderno_get_expense

Fetch a single expense by id. Quaderno API: GET /expenses/{id}.

read-only

Argument	Type	Description
id*	string	The resource id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "The resource id."
    }
  }
}

quaderno_get_invoice

Fetch a single invoice by id (full object incl. items, taxes, payments, permalink, pdf). Quaderno API: GET /invoices/{id}.

read-only

Argument	Type	Description
id*	string	The resource id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "The resource id."
    }
  }
}

quaderno_get_item

Fetch a single product/item by id. Quaderno API: GET /items/{id}.

read-only

Argument	Type	Description
id*	string	The resource id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "The resource id."
    }
  }
}

quaderno_get_receipt

Fetch a single receipt by id. Quaderno API: GET /receipts/{id}.

read-only

Argument	Type	Description
id*	string	The resource id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "The resource 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.

read-only

Argument	Type	Description
q	string	Search by contact name, email, or tax ID.
page	integer	Page number (legacy pagination; prefer created_before).
per_page	integer	Entries per page (1-100, default 25).
created_before	string	Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "q": {
      "type": "string",
      "description": "Search by contact name, email, or tax ID."
    },
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number (legacy pagination; prefer created_before)."
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Entries per page (1-100, default 25)."
    },
    "created_before": {
      "type": "string",
      "description": "Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record 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.

read-only

Argument	Type	Description
q	string	Search by number, customer name, or PO number.
date	string	Date range filter, e.g. "2026-01-01,2026-12-31".
page	integer	Page number (legacy pagination; prefer created_before).
contact	string	Filter by customer (contact) id.
per_page	integer	Entries per page (1-100, default 25).
created_before	string	Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "q": {
      "type": "string",
      "description": "Search by number, customer name, or PO number."
    },
    "date": {
      "type": "string",
      "description": "Date range filter, e.g. \"2026-01-01,2026-12-31\"."
    },
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number (legacy pagination; prefer created_before)."
    },
    "contact": {
      "type": "string",
      "description": "Filter by customer (contact) id."
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Entries per page (1-100, default 25)."
    },
    "created_before": {
      "type": "string",
      "description": "Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id)."
    }
  }
}

quaderno_list_expenses

List expenses (bills you received), newest first. Quaderno API: GET /expenses. Wrapped as { data, pagination } when more pages exist.

read-only

Argument	Type	Description
q	string	Search by number or vendor name.
date	string	Date range filter, e.g. "2026-01-01,2026-12-31".
page	integer	Page number (legacy pagination; prefer created_before).
contact	string	Filter by vendor (contact) id.
per_page	integer	Entries per page (1-100, default 25).
created_before	string	Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "q": {
      "type": "string",
      "description": "Search by number or vendor name."
    },
    "date": {
      "type": "string",
      "description": "Date range filter, e.g. \"2026-01-01,2026-12-31\"."
    },
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number (legacy pagination; prefer created_before)."
    },
    "contact": {
      "type": "string",
      "description": "Filter by vendor (contact) id."
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Entries per page (1-100, default 25)."
    },
    "created_before": {
      "type": "string",
      "description": "Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id)."
    }
  }
}

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.

read-only

Argument	Type	Description
q	string	Search by invoice number, customer name, or PO number.
date	string	Date range filter, e.g. "2026-01-01,2026-12-31".
page	integer	Page number (legacy pagination; prefer created_before).
state	string	Filter by invoice state.
contact	string	Filter by customer (contact) id.
per_page	integer	Entries per page (1-100, default 25).
created_before	string	Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "q": {
      "type": "string",
      "description": "Search by invoice number, customer name, or PO number."
    },
    "date": {
      "type": "string",
      "description": "Date range filter, e.g. \"2026-01-01,2026-12-31\"."
    },
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number (legacy pagination; prefer created_before)."
    },
    "state": {
      "enum": [
        "outstanding",
        "late",
        "uncollectible",
        "paid"
      ],
      "type": "string",
      "description": "Filter by invoice state."
    },
    "contact": {
      "type": "string",
      "description": "Filter by customer (contact) id."
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Entries per page (1-100, default 25)."
    },
    "created_before": {
      "type": "string",
      "description": "Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record 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.

read-only

Argument	Type	Description
page	integer	Page number (legacy pagination; prefer created_before).
per_page	integer	Entries per page (1-100, default 25).
created_before	string	Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number (legacy pagination; prefer created_before)."
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Entries per page (1-100, default 25)."
    },
    "created_before": {
      "type": "string",
      "description": "Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id)."
    }
  }
}

quaderno_list_jurisdictions

List the tax jurisdictions (id, name, country, region) where the account is registered to collect tax. Quaderno API: GET /jurisdictions.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

quaderno_list_receipts

List receipts, newest first. Quaderno API: GET /receipts. Wrapped as { data, pagination } when more pages exist.

read-only

Argument	Type	Description
q	string	Search by number or customer name.
date	string	Date range filter, e.g. "2026-01-01,2026-12-31".
page	integer	Page number (legacy pagination; prefer created_before).
contact	string	Filter by customer (contact) id.
per_page	integer	Entries per page (1-100, default 25).
created_before	string	Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record id).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "q": {
      "type": "string",
      "description": "Search by number or customer name."
    },
    "date": {
      "type": "string",
      "description": "Date range filter, e.g. \"2026-01-01,2026-12-31\"."
    },
    "page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "Page number (legacy pagination; prefer created_before)."
    },
    "contact": {
      "type": "string",
      "description": "Filter by customer (contact) id."
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Entries per page (1-100, default 25)."
    },
    "created_before": {
      "type": "string",
      "description": "Cursor for pagination: return records created before this id (from X-Pages-NextPage / a prior record 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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

quaderno_list_webhooks

List the account's configured webhooks (id, url, events). Quaderno API: GET /webhooks.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

quaderno_ping

Verify the API key and connection by pinging Quaderno. Returns account/authentication status. Quaderno API: GET /ping.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

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

read-only

Argument	Type	Description
path*	string	API path after /api, starting with a slash, e.g. "/tax_ids".
query	object	Optional query params object.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "path"
  ],
  "properties": {
    "path": {
      "type": "string",
      "description": "API path after /api, starting with a slash, e.g. \"/tax_ids\"."
    },
    "query": {
      "type": "object",
      "description": "Optional query params object.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    }
  }
}

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.

destructive

Argument	Type	Description
id*	string	The resource id.
email	string	Contact email address.
fields	object	Additional raw Quaderno fields merged into the request body (escape hatch for any field not typed above).
tax_id	string	Tax ID / VAT number.
country	string	2-letter ISO country code.
last_name	string	Person last name.
first_name	string	Person first name / company name.
contact_name	string	Contact person at a company.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "The resource id."
    },
    "email": {
      "type": "string",
      "description": "Contact email address."
    },
    "fields": {
      "type": "object",
      "description": "Additional raw Quaderno fields merged into the request body (escape hatch for any field not typed above).",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "tax_id": {
      "type": "string",
      "description": "Tax ID / VAT number."
    },
    "country": {
      "type": "string",
      "description": "2-letter ISO country code."
    },
    "last_name": {
      "type": "string",
      "description": "Person last name."
    },
    "first_name": {
      "type": "string",
      "description": "Person first name / company name."
    },
    "contact_name": {
      "type": "string",
      "description": "Contact person at a company."
    }
  }
}

Quaderno MCP by usefulapi

Try it

quaderno_calculate_tax

Quaderno MCP by usefulapi

Try it

quaderno_calculate_tax

Tools (23)