invoiceflow-mcp
InvoiceFlow MCP is an AI-powered invoice automation server that handles the full invoicing lifecycle — from client management and PDF creation to risk prediction, payment reconciliation, and cash flow reporting.
client_manage: Create or update clients with name, email, phone, address, tax ID, and company info. Required before creating invoices.invoice_create: Generate invoices with line items (description, quantity, unit price, tax rate, discount), auto-calculated totals, sequential invoice numbers (INV-YYYY-NNNN), and multi-currency support (USD, EUR, GBP, CAD, AUD, JPY, CHF, TRY, BRL, INR).invoice_list: Filter invoices by status (draft, sent, viewed, paid, overdue, cancelled, refunded), client, amount range, date range, or overdue status, with pagination.invoice_send: Generate a PDF and deliver it via SendGrid email (requiresSENDGRID_API_KEY); updates status to "sent".invoice_mark_paid: Record full or partial payments with a specified method (Stripe, PayPal, bank transfer, cash, check, crypto, etc.) and auto-update client payment history.invoice_remind: Send payment reminders with optional custom messages; tracks reminder count and timestamp.invoice_risk: Score late-payment risk (0–100) using four factors — invoice amount (20%), client history (35%), due date proximity (30%), reminder history (15%) — with recommended actions.cashflow_report: Portfolio-wide summary including total invoiced, collected, outstanding, overdue, collection rate, average days to payment, 30-day projection, and per-client breakdown.payment_reconcile: Match incoming payments to invoices by amount and payer email; auto-marks matched invoices as paid.
Predefined resources are also available: invoices://pending (unpaid invoices), invoices://overdue (overdue invoices), invoices://stats (monthly cash flow summary), and clients://list (all clients with payment history).
Provides automated payment reconciliation by matching incoming PayPal transactions to invoices using amount and payer email, marking matched invoices as paid.
Enables email delivery of professional PDF invoices and automated payment reminders through SendGrid's email service.
Provides automated payment reconciliation by matching incoming Stripe transactions to invoices using amount and payer email, marking matched invoices as paid.
InvoiceFlow MCP
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.
Features
Professional PDF invoices with line items, tax, discounts, multi-currency (10 currencies)
AI risk prediction (0-100) based on invoice amount, client history, due date, reminder history
Smart reminders with escalation based on risk level
Payment reconciliation matching incoming payments to invoices by amount + payer email (platform-agnostic — works with manually-entered or webhook-provided payment data)
Cash flow reporting with collection rate, projected income, client breakdown
Client management with automatic payment history tracking
Sequential invoice numbers (INV-2026-0001, INV-2026-0002, ...)
10 MCP tools + 4 MCP resources covering the full invoicing lifecycle
Related MCP server: Invoice Generator AI MCP
Quick Start
Install from MCPize Marketplace
Search for InvoiceFlow MCP on mcpize.com
Click Install — Free tools work immediately; unlock Pro with a €12 lifetime license (see Pro License)
Tools and resources are automatically available in any MCP-compatible client
Build from Source
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"]
}
}
}Tools
invoice_demo_seed
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.
client_manage
Create a new client. Required before creating invoices.
invoice_create
Create an invoice with line items. Auto-calculates subtotal, tax, discounts, and total. Generates sequential invoice numbers (INV-YYYY-NNNN).
invoice_send
Send an invoice PDF via email (requires SENDGRID_API_KEY). Updates status to "sent".
invoice_list
Filter invoices by status, client, amount range, date range, or overdue status. Supports pagination.
invoice_mark_paid
Mark an invoice as paid (full or partial). Updates client payment history automatically.
invoice_remind
Send a payment reminder. Increments reminder count. Supports custom messages.
invoice_risk
AI-powered late payment risk prediction (0-100). Returns risk level, factor breakdown, recommended action, next reminder date.
cashflow_report
Generate cash flow summary: total invoiced, collected, outstanding, overdue, collection rate, 30-day projection.
payment_reconcile
Match incoming payment to invoice by amount and payer email. Auto-marks as paid.
Resources
Resource | Description |
| All unpaid invoices |
| Invoices past due date |
| Monthly cash flow summary |
| All clients with payment history |
Risk Prediction Engine
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)
Configuration
Copy .env.example to .env and set the variables you need:
cp .env.example .envVariable | Required | Description |
| 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.
Roadmap: Stripe & PayPal live sync
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.
Usage Examples
Create a client and invoice
> Create a client "Acme Corp" with email billing@acme.com
✓ 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.00Assess payment risk
> 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.Generate cash flow report
> 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.00Supported Currencies
USD, EUR, GBP, CAD, AUD, JPY, CHF, TRY, BRL, INR
Pricing
Tier | Price | Tools | Features |
Free | €0 |
| PDF invoices, multi-currency, client management, manual reminders |
Pro | €12 lifetime | + | 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.
Development
npm run dev # Hot reload
npm run build # Production build
npm test # Run tests
npm run inspect # MCP InspectorTesting
Tests cover the core business logic:
Storage — CRUD operations, filtering, sequential invoice numbers
Risk Model — AI scoring engine with 4 weighted factors, risk classification
Cash Flow — Report generation, collection rates, projections, client breakdown
npm test # Run all tests
npx vitest --watch # Watch modePro License
InvoiceFlow 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 projection
Buy 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.
License
MIT License. See LICENSE for details.
Built by Automatia BCN.
Available Tools
10 toolscashflow_reportCash Flow ReportARead-onlyIdempotent
Generate a portfolio-wide cash flow summary across all invoices. Returns {period, total_invoiced, total_collected, total_outstanding, total_overdue, collection_rate (percent), avg_days_to_payment (or null if no paid history), projected_income_30d (forecast based on due dates and historical pay rate), breakdown_by_status, breakdown_by_client}. Takes no input — always reports on the current full dataset. Ideal for dashboards and monthly close.
Inputs: no named parameters.
client_manageManage ClientAIdempotent
Create or upsert a client record used by invoice_create. Accepts name, email, company, address, city, country, tax_id, phone, default_currency ("USD"|"EUR"|"GBP"|...) and notes. Returns the stored client object including the generated id (UUID), an empty payment_history (populated as invoices are paid), and timestamps. Safe to call repeatedly: if a client with the same email already exists, the existing record is returned unchanged.
Inputs: name (required), email (required), city, notes, +6 more.
invoice_createCreate InvoiceAIdempotent
Create a new invoice for an existing client. Required: client_id (UUID) and line_items (non-empty array of {description, quantity, unit_price, tax_rate?, discount_percent?} — tax and discount are per-line). Optional: currency (defaults to the client's default_currency then USD), issue_date (YYYY-MM-DD or full ISO, defaults to today), due_date (same format, defaults to issue_date + 30 days), notes, and terms. Auto-calculates subtotal, discount_total, tax_total, and total; generates a sequential invoice_number in format INV-YYYY-NNNN; sets status="draft". Returns the full invoice object ready for invoice_send.
Inputs: client_id (required), line_items (required), notes, terms, +3 more.
invoice_demo_seedSeed Demo DataA
Populate the store with a realistic demo dataset: 8 clients across 5 archetypes (on-time, late-payer, high-value, new, chronic-late) and 25-45 invoices spanning the last 6 months (paid, sent, and overdue). Every invoice has line items, tax, payment history, and reminder metadata. Use this to evaluate InvoiceFlow via MCP Inspector without real Stripe, SendGrid, or PayPal credentials — invoice_list, cashflow_report, invoice_risk, and payment_reconcile all return meaningful results against the returned ids. Safe to call multiple times; each call appends a fresh batch with unique UUIDs. Returns counts plus sample_invoice_ids you can feed straight into invoice_risk or invoice_mark_paid.
Inputs: no named parameters.
invoice_listList InvoicesARead-onlyIdempotent
Search and filter invoices. Optional filters: status ("draft"|"sent"|"viewed"|"paid"|"overdue"|"cancelled"|"refunded"), client_id, min_amount, max_amount, date_from/date_to (ISO dates), overdue_only (boolean). Pagination via limit (default 50, max 200) and offset. Returns {total, invoices[]} where each invoice includes full line_items and payment state. Use this to build dashboards or drive invoice_remind/invoice_risk workflows.
Inputs: limit, offset, status, to_date, +5 more.
invoice_mark_paidMark Invoice PaidA
Record a full or partial payment against an invoice. Updates amount_paid and amount_due; sets status="paid" only when the outstanding balance reaches zero. As a side effect, a fully-paid invoice updates the client payment_history (total_revenue, paid_invoices, avg_days_to_payment, late_payment_count) which invoice_risk then uses for future predictions. Returns a confirmation with the paid amount and remaining balance.
Inputs: invoice_id (required), amount, payment_method.
invoice_remindRecord Payment ReminderA
Record that a payment reminder has been issued for an unpaid invoice. Increments reminder_count, sets last_reminder_at, and advances draft → sent. Returns the generated reminder message (custom or default) so the caller can relay it through their preferred channel — this tool itself does not send email; use invoice_send for actual delivery. Safely refuses to remind on already-paid invoices.
Inputs: invoice_id (required), message.
invoice_riskAssess Payment RiskARead-onlyIdempotent
Predict late-payment risk for a specific invoice on a 0-100 scale. The model combines invoice amount (relative to client average), client payment history (avg_days_to_payment, late_payment_count), days remaining until due date, and prior reminder_count. Returns {risk_score (0-100), risk_level ("low"|"medium"|"high"|"critical"), factors (array of {factor, impact, detail}), recommended_action (string), next_reminder_date (ISO string or null)}. Use for prioritizing collection effort on high-value invoices.
Inputs: invoice_id (required).
invoice_sendSend InvoiceA
Generate the invoice PDF and deliver it to the client. Always generates the PDF and marks the invoice status="sent". Email delivery via SendGrid is attempted automatically when the SENDGRID_API_KEY environment variable is set; without it the PDF is still generated and the status still advances so the caller can handle delivery out-of-band. Returns a confirmation message with the PDF size.
Inputs: invoice_id (required), message.
payment_reconcileReconcile PaymentA
Match an incoming external payment (e.g. Stripe webhook, PayPal IPN, bank transfer) to an open invoice. Matching rule: the payer_email must equal the invoice client_email (case-insensitive) AND the payment_amount must equal the invoice amount_due within one cent. On match the invoice is marked paid, amount_paid/amount_due are updated, and client payment_history is recomputed exactly like invoice_mark_paid. Returns a reconciliation message on match or a "no match" message otherwise (no error). If multiple invoices match, the first one is reconciled.
Inputs: payer_email (required), payment_amount (required), reference, payment_method.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool has a distinct purpose: portfolio summary, client management, invoice creation, demo seeding, invoice listing, payment recording, reminder tracking, risk prediction, PDF generation/delivery, and external payment reconciliation. No functional overlap exists.
Most tools follow a noun_verb pattern (e.g., invoice_create, invoice_list), but invoice_risk and invoice_demo_seed deviate (noun_noun and noun_noun_verb), and cashflow_report could be interpreted as compound noun. Inconsistent imperative style.
10 tools is well-scoped for an invoicing system, covering core workflows (client, invoice, payment, report, risk) without unnecessary bloat.
Missing client listing/deletion and invoice update/deletion; lacks refund handling. Demo seeding and risk tools add value, but CRUD gaps may cause agent failures in some workflows.
Maintenance
Related MCP Connectors
Invoicing you drive by talking to your AI: log time, raise invoices and track what's owed via MCP.
Create, send and track invoices from a conversation in Claude, ChatGPT or any MCP client that supports OAuth. Draft an invoice from one sentence or from last month's invoice for the same client, finalize it, email it to your client and send payment reminders for overdue ones. See revenue by month and by client, download PDFs and e-invoices (ZUGFeRD, XRechnung), and export DATEV packages for your tax advisor. Invoices follow the tax rules of 25 countries, including reverse charge and the small-business VAT exemption. New invoices are drafts, and nothing is emailed until you ask. Pay per invoice with no subscription: the first invoice is free.
Automated invoicing from your AI assistant. Incoming invoice sync. Issue invoices and receipts.
Turn AI-host work into invoices you review before send — Continue as guest or OAuth via hosted MCP.
Related MCP Servers
- AlicenseBqualityBmaintenanceTurn Claude, Cursor, and your AI agents into an autonomous CFO. Manage invoicing, expenses, real-time bank reconciliation, cash flow, and tax compliance in plain language — backed by Frihet ERP.100977 npm13MIT
- AlicenseNot gradedqualityCmaintenanceInvoice Generator AI - MCP server providing AI-powered tools and automation by MEOK AI Labs3 npmMIT
- FlicenseNot gradedqualityCmaintenanceEnables MCP clients to search and inspect an invoice ledger, generate VAT summaries, run OCR on local documents, and use reusable prompts for chasing overdue invoices and reconciling entries.2-
- AlicenseNot gradedqualityBmaintenanceEnables AI agents and finance teams to extract structured fields from messy invoices and audit them before payment, applying seven evidence-backed risk rules that catch total/tax mismatches, duplicate invoices, missing fields, future dates, and round amounts, then returning a 0–100 score with a payment link. Exposes four MCP tools over stdio and Streamable HTTP (spec 2025-11-25) plus a web UI, backed by an optional AWS Bedrock or OpenAI-compatible extraction brain that degrades gracefully to a zero-dependency offline engine.MIT