Repository navigation
v1.0.0 — Initial production release
First production release of @digitaldev-lx/mcp-invoice-express.
MCP (Model Context Protocol) server for the InvoiceXpress API V2. Lets Claude Code and any other MCP-aware client operate the Portuguese invoicing platform directly.
Install in one line
claude mcp add invoice-express \
--env INVOICE_EXPRESS_ACCOUNT_NAME=your-account-subdomain \
--env INVOICE_EXPRESS_API_KEY=your-api-key \
-- npx -y @digitaldev-lx/mcp-invoice-expressHighlights
- 25 high-level tools + raw fallback covering the entire V2 API surface (invoices, simplified invoices, credit notes, debit notes, receipts, estimates, guides, purchase orders, clients, items, taxes, sequences, accounts, treasury, SAF-T).
- 3 read-only resources (recent invoices, clients, account info) and 2 workflow prompts (create_invoice_workflow, monthly_close_workflow).
- Single account per instance via
INVOICE_EXPRESS_ACCOUNT_NAME+INVOICE_EXPRESS_API_KEYenv vars; multi-account by configuring multiple MCP servers. - Retry & backoff on 429/5xx with typed error hierarchy.
- TypeScript sources, Zod validation, 27 vitest tests.
- One-liner install, Stdio transport, no extra dependencies.
See the README for the full reference.
Requirements
- Node.js 20+
- An InvoiceXpress account with an API key
License
MIT