mcpField
I
invovate-mcp-server

invovate-mcp-server

Local
github.com/LightSpeedPlusOneFinance1Updated 21w ago

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

  1. 01Calculate invoice totals
  2. 02Generate PDF invoices
  3. 03Generate UBL 2.1 XML
  4. 04Support 11 invoice languages
  5. 05List currencies, templates, and capabilities

Use cases

  1. 01Calculate tax and balance due
  2. 02Create a PDF invoice for a client
  3. 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.

mcp.json · Universal config
{
"mcpServers": {
"lightspeedplusone-invovate": {
"command": "npx",
"args": [
"-y",
"invovate-mcp-server"
],
"env": {
"INVOVATE_API_KEY": "<INVOVATE_API_KEY>",
"INVOVATE_API_BASE": "<INVOVATE_API_BASE>"
}
}
}
}
Run commandnpx -y invovate-mcp-server
Environment variables to set
INVOVATE_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.

Packages
npminvovate-mcp-server0.1.1

Tools

4

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
toobjectYesThe customer being billed.
to.nameanyYes
to.emailanyNo
to.tax_idanyNo
to.addressanyNo
datestringNoISO date, e.g. 2026-06-01.
fromobjectYesThe business issuing the invoice.
from.namestringYesParty name (required).
from.emailstringNo
from.tax_idstringNoVAT / GST / tax registration number.
from.addressstringNoMulti-line address; use \n for line breaks.
itemsarrayYesLine items (at least one).
notesstringNo
termsstringNoPayment terms, e.g. "Net 30".
numberstringNoInvoice number; auto-generated if omitted.
depositnumberNo
paymentobjectNo
payment.ibanstringNo
payment.swiftstringNo
payment.pay_tostringNo
payment.bank_namestringNo
payment.method_notestringNoe.g. "Paid by card ending **999".
payment.account_namestringNo
payment.account_numberstringNo
currencystringNoISO 4217 code, e.g. USD, EUR, GBP. Default USD.
due_datestringNo
languageenumNoInvoice language. Default en. ar/ja/hi/ru render with embedded fonts.en | nl | de | fr | es | it | pt | ar | ja | ru | hi
shippingnumberNo
templateenumNoPDF template. Default classic.classic | modern | bold | minimal | navy
po_numberstringNo
global_taxnumberNoTax % applied to all lines without their own tax_rate.
amount_paidnumberNoAmount already paid (for partial invoices).
accent_colorstringNoHex color like #2563eb.
global_discountnumberNo
global_discount_typeenumNopercent | amount

Details

From the project README

Invovate MCP Server

npm MCP Registry Glama OpenAPI License: MIT

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

ToolWhat it doesKey needed
calculate_invoice_totalsCompute subtotal, discounts, tax, shipping, deposit, grand total, balance due — no file rendered.No
generate_invoice_pdfGenerate a PDF. Returns a 7-day hosted link (great for chat), or writes the file when save_path is given.Required
generate_invoice_ublGenerate UBL 2.1 XML (interoperability/archival only — not regulated e-invoicing).Yes
get_invoice_capabilitiesList 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 varDefaultPurpose
INVOVATE_API_KEY—Free API key (inv_…). Enables PDF/UBL output and hosted links.
INVOVATE_API_BASEhttps://invovate.comOverride 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

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

License

MIT © Invovate

Comments

Markdown supported

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.