QuickInvoice MCP by usefulapi
Read and create invoices, and read customers, products and services in QuickInvoice.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"quickinvoice": {
"url": "https://quickinvoice.usefulapi.io/mcp"
}
}
}Remote endpoints
https://quickinvoice.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (7)
🟢quickinvoice_list_invoices(status, type, customer_id, search, date_from, ...)
List invoices of the company that owns the API key, newest first. Filter by status, type, customer, search text or date range. Uses GET /api/v1/invoices.
Input Schema
{
"type": "object",
"properties": {
"status": {
"description": "Invoice status filter.",
"type": "string",
"enum": [
"DRAFT",
"SENT",
"VIEWED",
"PAID",
"PARTIAL",
"OVERDUE",
"CANCELED"
]
},
"type": {
"description": "Document type filter.",
"type": "string",
"enum": [
"INVOICE",
"PROFORMA",
"DELIVERY_NOTE"
]
},
"customer_id": {
"description": "Only invoices of this customer id.",
"type": "string"
},
"search": {
"description": "Free-text search (number, customer name).",
"type": "string"
},
"date_from": {
"description": "Earliest issue date, yyyy-mm-dd.",
"type": "string"
},
"date_to": {
"description": "Latest issue date, yyyy-mm-dd.",
"type": "string"
},
"page": {
"description": "Page number (default 1).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Rows per page (max 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢quickinvoice_get_invoice(invoice_id)
Get one invoice by id, with its lines, totals, status and customer. Uses GET /api/v1/invoices/{id}.
Input Schema
{
"type": "object",
"properties": {
"invoice_id": {
"type": "string",
"minLength": 1,
"description": "The invoice id (from the matching list tool)."
}
},
"required": [
"invoice_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴quickinvoice_create_invoice(customer_name, customer_cif, customer_email, series, items)
Create an invoice for the company that owns the API key (POST /api/v1/invoices). unit_price is the NET price per unit; VAT is computed from tax_rate. A new invoice can use a number in its series. Confirm the customer, lines, amounts and series with the user before calling. Needs the invoices:write key permission.
Input Schema
{
"type": "object",
"properties": {
"customer_name": {
"type": "string",
"minLength": 1,
"description": "Customer name as it appears on the invoice."
},
"customer_cif": {
"description": "Customer tax id (CIF / CUI), e.g. RO12345678.",
"type": "string"
},
"customer_email": {
"description": "Customer e-mail address.",
"type": "string"
},
"series": {
"description": "Invoice series. Omit to use the company's default series.",
"type": "string"
},
"items": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"description": {
"type": "string",
"minLength": 1,
"description": "Line description."
},
"quantity": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Quantity."
},
"unit_price": {
"type": "number",
"minimum": 0,
"description": "NET unit price (VAT excluded)."
},
"tax_rate": {
"type": "number",
"minimum": 0,
"maximum": 100,
"description": "VAT rate in percent, e.g. 21."
}
},
"required": [
"description",
"quantity",
"unit_price",
"tax_rate"
]
},
"description": "Invoice lines (1 to 100)."
}
},
"required": [
"customer_name",
"items"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢quickinvoice_list_customers(search, limit, offset)
List customers of the company, with optional text search. Uses GET /api/v1/customers.
Input Schema
{
"type": "object",
"properties": {
"search": {
"description": "Free-text search (name, tax id, phone).",
"type": "string"
},
"limit": {
"description": "Rows to return (max 100).",
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 100
},
"offset": {
"description": "Rows to skip (for paging).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢quickinvoice_get_customer(customer_id)
Get one customer by id. Uses GET /api/v1/customers/{id}.
Input Schema
{
"type": "object",
"properties": {
"customer_id": {
"type": "string",
"minLength": 1,
"description": "The customer id (from the matching list tool)."
}
},
"required": [
"customer_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢quickinvoice_list_products(search, category_id, type)
List the company's products and services (read-only in the API), with optional search, category and type filters. Uses GET /api/v1/products.
Input Schema
{
"type": "object",
"properties": {
"search": {
"description": "Free-text search (name, SKU).",
"type": "string"
},
"category_id": {
"description": "Only items of this category id.",
"type": "string"
},
"type": {
"description": "Only products or only services.",
"type": "string",
"enum": [
"PRODUCT",
"SERVICE"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢quickinvoice_get_product(product_id)
Get one product or service by id, with its price and VAT rate. Uses GET /api/v1/products/{id}.
Input Schema
{
"type": "object",
"properties": {
"product_id": {
"type": "string",
"minLength": 1,
"description": "The product id (from the matching list tool)."
}
},
"required": [
"product_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence