Invoiceflow Mcp

InvoiceFlow MCP

Model Context Protocol 向けの AI 搭載請求書自動化

InvoiceFlow は、プロフェッショナルな PDF 請求書を作成し、AI を使って支払い遅延リスクを予測し、リマインダーを自動送信し、入金と請求書を照合して、キャッシュフローを追跡します。すべて MCP プロトコルを通じて行えます。

---

機能

• プロフェッショナルな PDF 請求書。明細項目、税金、割引、複数通貨（10 通貨）に対応
• AI リスク予測（0～100）。請求金額、クライアントの履歴、支払期限、リマインダーの履歴に基づいて予測します
• スマートリマインダー。リスクレベルに応じて段階的に対応します
• 入金照合。金額と支払者のメールアドレスで入金と請求書を照合します（プラットフォームに依存せず、手動入力または Webhook で提供された入金データに対応）
• キャッシュフローレポート。回収率、予測収入、クライアント別内訳を表示します
• クライアント管理。支払い履歴を自動で追跡します
• 連番の請求書番号（INV-2026-0001、INV-2026-0002、...）
• 請求業務の全工程を網羅する 10 個の MCP ツール と 4 個の MCP リソース

---

クイックスタート

MCPize Marketplace からインストール

1. mcpize.com で InvoiceFlow MCP を検索します
2. Install をクリックします。無料ツールはすぐに利用できます。€12 の買い切りライセンスで Pro を利用できます（Pro ライセンスを参照）
3. ツールとリソースは、MCP 対応クライアントで自動的に利用可能になります

ソースからビルド

git clone https://github.com/enzoemir1/invoiceflow-mcp.git
cd invoiceflow-mcp
npm ci
npm run build

MCP クライアントの設定に追加します。

{
  "mcpServers": {
    "invoiceflow": {
      "command": "node",
      "args": ["path/to/invoiceflow-mcp/dist/index.js"]
    }
  }
}

---

ツール

invoice_demo_seed

リアルなデモデータセット（5 種類の利用パターンにまたがる 8 社のクライアント（期日どおりに支払うクライアント、支払いの遅いクライアント、高額取引のクライアント、新規クライアント、常習的に支払いが遅れるクライアント）と、過去 6 か月分の 25～45 件の請求書）を登録します。認証情報がなくても、すべてのツールから有意義な結果を得られるようになります。複数回安全に呼び出せます。呼び出すたびに、一意の UUID を持つ新しいデータが追加されます。件数と sample_invoice_ids を返します。

client_manage

新しいクライアントを作成します。請求書を作成する前に必要です。

invoice_create

明細項目を含む請求書を作成します。小計、税金、割引、合計を自動計算します。連番の請求書番号（INV-YYYY-NNNN）を生成します。

invoice_send

請求書の PDF をメールで送信します（SENDGRID_API_KEY が必要です）。ステータスを「sent」に更新します。

invoice_list

ステータス、クライアント、金額の範囲、日付の範囲、または支払期限超過の有無で請求書を絞り込みます。ページネーションに対応しています。

invoice_mark_paid

請求書を全額または一部支払い済みにします。クライアントの支払い履歴も自動的に更新します。

invoice_remind

支払いリマインダーを送信します。リマインダーの送信回数を増やします。カスタムメッセージに対応しています。

invoice_risk

AI による支払い遅延リスク予測（0～100）を行います。リスクレベル、要因の内訳、推奨アクション、次回リマインダーの日付を返します。

cashflow_report

キャッシュフローの概要を生成します。請求総額、回収済み金額、未回収額、支払期限超過額、回収率、30 日間の収入予測を含みます。

payment_reconcile

金額と支払者のメールアドレスで入金と請求書を照合します。支払い済みとして自動的にマークします。

---

リソース

リソース	説明
invoices://pending	未払いの請求書すべて
invoices://overdue	支払期限を過ぎた請求書
invoices://stats	月ごとのキャッシュフロー概要
clients://list	支払い履歴を含むすべてのクライアント

---

リスク予測エンジン

4 つの加重要因を使って、請求書のスコアを 0～100 で算出します。

要因	重み	測定内容
請求金額	20%	金額が高いほどリスクも高くなります
クライアントの履歴	35%	支払い率、支払い遅延、平均日数
支払期限	30%	支払期限まで、または期限超過からの日数
リマインダー	15%	すでに送信したリマインダー

リスクレベル： 低（0～30）、中（31～60）、高（61～100）

---

設定

.env.example を .env にコピーし、必要な変数を設定します。

cp .env.example .env

変数	必須	説明
SENDGRID_API_KEY	メール送信時	SendGrid 経由で請求書とリマインダーを送信します

SendGrid は任意です。InvoiceFlow は、請求書の作成、リスクスコアリング、キャッシュフローのレポート作成、照合をすべてオフラインで行えます。メールを送信する場合は、SendGrid を追加してください。

ロードマップ：Stripe と PayPal のライブ同期

現在、payment_reconcile ツールは、指定した金額（CSV、Webhook、手動入力など）と保存済みの請求書を照合します。Stripe と PayPal の API との直接連携および Webhook リスナーは v2.0 での実装を予定しています。進捗についてはissuesをご覧ください。

使用例

クライアントと請求書を作成する

> 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.00

対応通貨

USD、EUR、GBP、CAD、AUD、JPY、CHF、TRY、BRL、INR

---

料金

プラン	価格	ツール	機能
Free	€0	invoice_demo_seed、client_manage、invoice_create、invoice_list、invoice_mark_paid、invoice_remind	PDF 請求書、複数通貨、クライアント管理、手動リマインダー
Pro	€12 買い切り	+ invoice_send、invoice_risk、payment_reconcile、cashflow_report	AI リスクスコアリング、SendGrid によるメール配信、支払い照合、キャッシュフローレポート

€12 の買い切りライセンス（3 台）で、サブスクリプションはありません。購入と有効化については、以下の Pro ライセンス をご覧ください。

---

開発

npm run dev        # Hot reload
npm run build      # Production build
npm test           # Run tests
npm run inspect    # MCP Inspector

テスト

テストでは、主要なビジネスロジックを網羅しています。

• ストレージ — CRUD 操作、フィルタリング、請求書番号の連番
• リスクモデル — 4 つの重み付け要素を用いた AI スコアリングエンジン、リスク分類
• キャッシュフロー — レポート生成、回収率、予測、クライアント別内訳

npm test           # Run all tests
npx vitest --watch # Watch mode

Pro ライセンス

InvoiceFlow は Free モードで提供されます。invoice_demo_seed、client_manage、invoice_create、invoice_list、invoice_mark_paid、invoice_remind はオープンです。以下のツールには Pro ライセンスが必要です。

• invoice_send — PDF を生成し、SendGrid でメールを配信します
• invoice_risk — 支払い遅延のリスクを予測します
• payment_reconcile — Stripe／PayPal／銀行の支払いと請求書を照合します
• cashflow_report — ポートフォリオ全体のキャッシュフローと30日間の予測を表示します

Pro ライセンスを購入（€12、買い切り、3 台）： https://automatiabcn.lemonsqueezy.com/buy/2d439c05-f463-4137-8883-950e8ee1112d

または、Indie MCP Stack Bundle（€69、全4サーバー）をご利用ください。

export LEMONSQUEEZY_LICENSE_KEY=YOUR-KEY-HERE

または、MCP クライアントの設定で指定します。

{
  "mcpServers": {
    "invoiceflow-mcp": {
      "command": "npx",
      "args": ["-y", "invoiceflow-mcp-server"],
      "env": { "LEMONSQUEEZY_LICENSE_KEY": "YOUR-KEY-HERE" }
    }
  }
}

検証結果はローカルに24時間キャッシュされるため、初回実行後は完全にオフラインで利用できます。

---

ライセンス

MIT License。詳細は LICENSE をご覧ください。

Automatia BCN が開発しました。