
AI-powered invoice automation for MCP. Create PDF invoices, predict late payments, auto-remind, and
AI-powered invoice automation for MCP. Create PDF invoices, predict late payments, auto-remind, and track cash flow.
·
AI-powered invoice automation for the Model Context Protocol
InvoiceFlow creates professional PDF invoices, predicts late payment risk using AI, auto-sends reminders, matches incoming payments to invoices, and tracks your cash flow -- all through the MCP protocol.
git clone https://github.com/enzoemir1/invoiceflow-mcp.git
cd invoiceflow-mcp
npm ci
npm run buildAdd to your MCP client config:
{
"mcpServers": {
"invoiceflow": {
"command": "node",
"args": ["path/to/invoiceflow-mcp/dist/index.js"]
}
}
}Seed a realistic demo dataset — 8 clients across 5 archetypes (on-time, late-payer, high-value, new, chronic-late) and 25-45 invoices over the last 6 months — so every tool returns meaningful output without any credentials. Safe to call multiple times; each call appends a fresh batch with unique UUIDs. Returns counts plus sample_invoice_ids.
Create a new client. Required before creating invoices.
Create an invoice with line items. Auto-calculates subtotal, tax, discounts, and total. Generates sequential invoice numbers (INV-YYYY-NNNN).
Send an invoice PDF via email (requires SENDGRID_API_KEY). Updates status to "sent".
Filter invoices by status, client, amount range, date range, or overdue status. Supports pagination.
Mark an invoice as paid (full or partial). Updates client payment history automatically.
Send a payment reminder. Increments reminder count. Supports custom messages.
AI-powered late payment risk prediction (0-100). Returns risk level, factor breakdown, recommended action, next reminder date.
Generate cash flow summary: total invoiced, collected, outstanding, overdue, collection rate, 30-day projection.
Match incoming payment to invoice by amount and payer email. Auto-marks as paid.
| Resource | Description |
|---|---|
invoices://pending | All unpaid invoices |
invoices://overdue | Invoices past due date |
invoices://stats | Monthly cash flow summary |
clients://list | All clients with payment history |
Scores invoices 0-100 using 4 weighted factors:
| Factor | Weight | What It Measures |
|---|---|---|
| Invoice Amount | 20% | Higher amounts = higher risk |
| Client History | 35% | Pay rate, late payments, avg days |
| Due Date | 30% | Days until/past due |
| Reminders | 15% | Reminders already sent |
Risk Levels: Low (0-30), Medium (31-60), High (61-100)
Copy .env.example to .env and set the variables you need:
cp .env.example .env| Variable | Required | Description |
|---|---|---|
SENDGRID_API_KEY | For email sending | Send invoices and reminders via SendGrid |
SendGrid is optional. InvoiceFlow works fully offline for invoice creation, risk scoring, cash flow reporting, and reconciliation. Add SendGrid when you want outbound email delivery.
The payment_reconcile tool currently matches amounts you provide (from a CSV, a webhook, or manual entry) against stored invoices. Direct Stripe and PayPal API integration with webhook listeners is planned for v2.0 — see issues for progress.
> Create a client "Acme Corp" with email [email protected]
✓ Client created: Acme Corp (id: 3f2a...)
> Create an invoice for Acme Corp: 10 hours consulting at $150/hr, 20% tax
✓ Invoice INV-2026-0001 created
Subtotal: $1,500.00 | Tax: $300.00 | Total: $1,800.00> What's the risk score for invoice INV-2026-0001?
Risk Score: 42/100 (Medium)
- Invoice Amount: 25 (moderate amount)
- Client History: 50 (new client)
- Due Date: 15 (due in 28 days)
- Reminders: 10 (none sent)
Recommended: Send an early reminder with a polite tone.> Show me the cash flow report
April 2026:
Total Invoiced: $12,400.00
Collected: $8,200.00 (66.1%)
Outstanding: $4,200.00
Overdue: $1,800.00
Projected (30d): $2,400.00USD, EUR, GBP, CAD, AUD, JPY, CHF, TRY, BRL, INR
| Tier | Price | Tools | Features |
|---|---|---|---|
| Free | €0 | invoice_demo_seed, client_manage, invoice_create, invoice_list, invoice_mark_paid, invoice_remind | PDF invoices, multi-currency, client management, manual reminders |
| Pro | €12 lifetime | + invoice_send, invoice_risk, payment_reconcile, cashflow_report | AI risk scoring, SendGrid delivery, payment reconciliation, cash flow reporting |
One-time €12 lifetime license (3 machines) — no subscription. See Pro License below to buy and activate.
npm run dev # Hot reload
npm run build # Production build
npm test # Run tests
npm run inspect # MCP InspectorTests cover the core business logic:
npm test # Run all tests
npx vitest --watch # Watch modeInvoiceFlow ships in Free mode — invoice_demo_seed, client_manage, invoice_create, invoice_list, invoice_mark_paid, and invoice_remind are open. The following tools require a Pro license:
invoice_send — generate PDF + SendGrid email deliveryinvoice_risk — late-payment risk predictionpayment_reconcile — match Stripe/PayPal/bank payments to invoicescashflow_report — portfolio-wide cash flow + 30-day projectionBuy a Pro License (€12, lifetime, 3 machines): https://automatiabcn.lemonsqueezy.com/buy/2d439c05-f463-4137-8883-950e8ee1112d
Or get the Indie MCP Stack Bundle (€69, all 4 servers).
export LEMONSQUEEZY_LICENSE_KEY=YOUR-KEY-HEREOr in your MCP client config:
{
"mcpServers": {
"invoiceflow-mcp": {
"command": "npx",
"args": ["-y", "invoiceflow-mcp-server"],
"env": { "LEMONSQUEEZY_LICENSE_KEY": "YOUR-KEY-HERE" }
}
}
}Validation is cached locally for 24 h — fully offline-capable after first run.
MIT License. See LICENSE for details.
Built by Automatia BCN.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add invoiceflow -- node path/to/invoiceflow-mcp/dist/index.js{
"mcpServers": {
"invoiceflow": {
"args": [
"path/to/invoiceflow-mcp/dist/index.js"
],
"command": "node"
}
}
}code --add-mcp '{"name":"invoiceflow","args":["path/to/invoiceflow-mcp/dist/index.js"],"command":"node"}'[mcp_servers.invoiceflow]
command = "node"
args = ["path/to/invoiceflow-mcp/dist/index.js"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/invoiceflow-mcp to learn what the "InvoiceFlow MCP" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
npx vitest --watch # Watch modeThis server runs locally, so we can't read its tool list over the web yet.
We could not run this server: its npm package has not answered in our offline sandbox, which usually means it needs an API key or other configuration to start. The four checks that need a live server are left out, and the grade tops out at B until we can read its tools.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/invoiceflow-mcp)Nothing comparable is listed yet.
v1.4.2v1.4.2 — bundle license gating into published artifactRelease notesv1.4.1v1.4.1 — Glama TDQS schema description coverageRelease notesv1.4.0Release notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "invoiceflow-mcp" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.