About invovate-mcp-server
Invovate MCP Server lets AI agents and MCP clients generate invoices through the Invovate API. It supports PDF, JSON, and UBL 2.1 output in 11 languages, with invoice arithmetic available without an API key.
Key features
- 01Calculate invoice totals
- 02Generate PDF invoices
- 03Generate UBL 2.1 XML
- 04Support 11 invoice languages
- 05List currencies, templates, and capabilities
Use cases
- 01Calculate tax and balance due
- 02Create a PDF invoice for a client
- 03Export an invoice as UBL 2.1
MCP support
Provides invoice-calculation, PDF and UBL generation, and capability-listing tools to MCP clients. Totals need no key; PDF and UBL generation require a free Invovate API key.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y invovate-mcp-serverINVOVATE_API_KEYSecretFree Invovate API key (starts with inv_) from https://invovate.com/auth. Required only for the PDF/UBL tools; calculate_invoice_totals works without it.INVOVATE_API_BASEOverride the API base URL (defaults to https://invovate.com).Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
4Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| to | object | Yes | The customer being billed. |
| to.name | any | Yes | |
| to.email | any | No | |
| to.tax_id | any | No | |
| to.address | any | No | |
| date | string | No | ISO date, e.g. 2026-06-01. |
| from | object | Yes | The business issuing the invoice. |
| from.name | string | Yes | Party name (required). |
| from.email | string | No | |
| from.tax_id | string | No | VAT / GST / tax registration number. |
| from.address | string | No | Multi-line address; use \n for line breaks. |
| items | array | Yes | Line items (at least one). |
| notes | string | No | |
| terms | string | No | Payment terms, e.g. "Net 30". |
| number | string | No | Invoice number; auto-generated if omitted. |
| deposit | number | No | |
| payment | object | No | |
| payment.iban | string | No | |
| payment.swift | string | No | |
| payment.pay_to | string | No | |
| payment.bank_name | string | No | |
| payment.method_note | string | No | e.g. "Paid by card ending **999". |
| payment.account_name | string | No | |
| payment.account_number | string | No | |
| currency | string | No | ISO 4217 code, e.g. USD, EUR, GBP. Default USD. |
| due_date | string | No | |
| language | enum | No | Invoice language. Default en. ar/ja/hi/ru render with embedded fonts.en | nl | de | fr | es | it | pt | ar | ja | ru | hi |
| shipping | number | No | |
| template | enum | No | PDF template. Default classic.classic | modern | bold | minimal | navy |
| po_number | string | No | |
| global_tax | number | No | Tax % applied to all lines without their own tax_rate. |
| amount_paid | number | No | Amount already paid (for partial invoices). |
| accent_color | string | No | Hex color like #2563eb. |
| global_discount | number | No | |
| global_discount_type | enum | No | percent | amount |
Details
From the project READMEInvovate MCP Server
Invovate MCP Server is a free, no-signup invoice MCP server for Claude, Cursor, and other MCP clients — it generates invoices as PDF, JSON, and UBL 2.1 via the Invovate invoice API.
Let AI agents generate PDF, JSON, and UBL 2.1 invoices in 11 languages (including right-to-left Arabic, Japanese, Hindi, and Cyrillic) through the Invovate invoice API. Works with Claude Desktop, Cursor, Windsurf, and any MCP-capable client.
JSON math works with no API key; PDF/UBL output uses a free key.
Tools
| Tool | What it does | Key needed |
|---|---|---|
calculate_invoice_totals | Compute subtotal, discounts, tax, shipping, deposit, grand total, balance due — no file rendered. | No |
generate_invoice_pdf | Generate a PDF. Returns a 7-day hosted link (great for chat), or writes the file when save_path is given. | Required |
generate_invoice_ubl | Generate UBL 2.1 XML (interoperability/archival only — not regulated e-invoicing). | Yes |
get_invoice_capabilities | List supported languages, templates, currencies, and features. | No |
Get a free API key
Sign up at https://invovate.com/auth — your key starts with inv_. Free tier,
no credit card. (calculate_invoice_totals works without a key; PDF, UBL, QR, and hosted links require a free key.)
Install
Claude Desktop
Add to claude_desktop_config.json
(~/Library/Application Support/Claude/claude_desktop_config.json on macOS,
%APPDATA%\Claude\claude_desktop_config.json on Windows):
{
"mcpServers": {
"invovate": {
"command": "npx",
"args": ["-y", "invovate-mcp-server"],
"env": { "INVOVATE_API_KEY": "inv_your_key_here" }
}
}
}
Restart Claude Desktop. Then ask: “Create an invoice for Acme BV billing Globex for 3 consulting days at €900/day with 21% VAT, in English, and give me the PDF.”
Cursor / Windsurf
Add the same block to the MCP config (~/.cursor/mcp.json for Cursor, or the
Windsurf MCP settings).
Run from source (before npm publish)
git clone https://github.com/LightSpeedPlusOne/invovate-mcp-server.git
cd invovate-mcp-server && npm install
INVOVATE_API_KEY=inv_your_key node src/index.js
…and point your client at it:
{
"mcpServers": {
"invovate": {
"command": "node",
"args": ["/absolute/path/to/mcp-server/src/index.js"],
"env": { "INVOVATE_API_KEY": "inv_your_key_here" }
}
}
}
Configuration
| Env var | Default | Purpose |
|---|---|---|
INVOVATE_API_KEY | — | Free API key (inv_…). Enables PDF/UBL output and hosted links. |
INVOVATE_API_BASE | https://invovate.com | Override the API base (rarely needed). |
Test
npm test # lists tools + JSON math (no key)
INVOVATE_API_KEY=inv_xxx npm test # also exercises the PDF hosted-link path
Notes
- Not regulated e-invoicing. UBL export is for interoperability/archival only. No Peppol / Factur-X / ZUGFeRD / XRechnung / NF-e compliance or network delivery.
- Hosted links expire and the invoice is deleted after 7 days.
- Docs for agents: https://invovate.com/invoice-api-for-ai-agents · OpenAPI: https://invovate.com/openapi.json
Example prompts
Once connected, ask your AI client in natural language:
Create an invoice for Acme Ltd for 3 hours of consulting at $120/hour. Return it as a PDF.
Generate a UBL 2.1 invoice for a SaaS subscription charged €49/month.
Make a Japanese invoice (¥) for ¥350,000 of web design with 10% consumption tax, and give me the link.
Links
- Invoice API & docs: https://invovate.com/api · https://invovate.com/invoice-api-for-ai-agents
- OpenAPI 3.1 spec: https://invovate.com/openapi.json (import as a ChatGPT / Claude Action)
- MCP landing page: https://invovate.com/mcp-invoice-generator · All integrations: https://invovate.com/integrations
- npm (this package): https://www.npmjs.com/package/invovate-mcp-server
- Python SDK: https://pypi.org/project/invovate/ · JavaScript SDK: https://www.npmjs.com/package/invovate
- Glama MCP directory: https://glama.ai/mcp/servers/LightSpeedPlusOne/invovate-mcp-server
- Postman collection: https://www.postman.com/lightspeedplusone-9440989/workspace/invovate-invoice-api/overview
- RapidAPI: https://rapidapi.com/LightSpeedPlusOne/api/invovate-invoice
- WordPress plugin: https://wordpress.org/plugins/invovate-invoice-generator/
License
MIT © Invovate
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.