QuickInvoice MCP by usefulapi

Read and create invoices, and read customers, products and services in QuickInvoice.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
96%
Naming quality
80%
Poisoning risk
100%
Permission match
100%
Protocol compliance
100%

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~1,255Tokens (tool definitions)
~1.4 KBTypical response size
Moderate attention impact (0.98% of 128k context)

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-http

What it can do

Tool inventory

Tools (7)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢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

Rate this Server

Evidence

Recent observations

verifiedversion not recorded7 tools