dunning-letters

支払期限を過ぎた請求書への自動督促

公式 MCP レジストリに登録されています（io.github.theluckystrike/dunning-letters）。 支払期限を過ぎた請求書を、経緯を見失うことなく督促できます。未払いの請求書、クライアント、請求書番号、整数のセント単位の金額、通貨、支払期限を登録すると、サーバーが督促の段階を進めます。リマインダー 1（丁寧な文面、支払期限から 7 日後）、リマインダー 2（強めの文面、遅延料金に関する注記付き、支払期限から 14 日後）、最終通知（法的措置前の文面、支払期限から 21 日後）を作成します（間隔は請求書ごとに設定できます）。各段階では、Markdown または単体で印刷できる HTML ページとして督促状を生成します。送付した内容と日付を記録し、延滞日数と段階を含む延滞請求書の一覧を表示し、登録全体を未延滞／30 日／60 日／90 日以上の区分に分類して経過期間を集計し、「今日送る必要があるものは何か」に回答します。メール送信や外部への送信は行いません。このサーバーが作成するのは督促状の文面であり、送信するのはユーザー自身です。

theluckystrike が開発しました。

@theluckystrike/mcp-dunning-letters の npm 公開は保留中のため、現時点では npx -y @theluckystrike/mcp-dunning-letters を実行すると 404 が返されます。それまでは、リポジトリをクローンしてビルドする方法が利用できます。

インストール

Claude Desktop

macOS の場合は ~/Library/Application Support/Claude/claude_desktop_config.json、Windows の場合は %APPDATA%\Claude\claude_desktop_config.json：

{
  "mcpServers": {
    "dunning-letters": {
      "command": "npx",
      "args": ["-y", "@theluckystrike/mcp-dunning-letters"]
    }
  }
}

Claude Code

claude mcp add dunning-letters -- npx -y @theluckystrike/mcp-dunning-letters

Cursor

~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクト）に、Claude Desktop と同じエントリを設定します。

ツール

ツール	機能
invoice_register	未払い請求書の督促を開始します。クライアント、請求書番号、金額、通貨、支払期限を登録します。DUN-YYYY-NNNN と 3 つの督促日を返します
payment_record	全額または一部の入金を記録します。一部入金があると、次の督促状に記載する金額が減り、残高が全額支払われると督促の段階が終了します
letter_render	現在の段階（リマインダー 1、リマインダー 2、最終通知）の督促状を、Markdown または単体で印刷できる HTML として生成します。メール送信は行いません。生成された文面はユーザー自身が送信します
letter_sent	督促状を実際に送付したことを日付とともに記録し、督促の段階を進めます。督促状は順番に送付されます
overdue_list	支払期限を過ぎたすべての未払い請求書を表示します。延滞日数、未払い残高、送付済みの督促状、次に送る督促状を含み、延滞期間が長い順に表示します
aging_summary	登録全体を未延滞／1～30／31～60／61～90／91 日以上の区分に分類して表示します。通貨ごとに件数と整数のセント単位の合計を表示します
chase_today	今日の督促一覧を表示します。今日督促段階の基準日を迎える請求書、各請求書に送る督促状、次回の予定日を確認できます
invoice_status	督促中の請求書 1 件の詳細を表示します。入金、督促状、スケジュール、次の対応を確認できます
invoice_delete	誤って登録した請求書を削除します。ID は再発行されません
license_status / license_activate	Free または Pro のライセンスとキーを確認・有効化します

Free と Pro の比較

	Free	Pro
同時に督促できる未払い請求書数	3	無制限
3 種類の督促状すべて、両方の形式	はい	はい
延滞期間の集計と今日の督促一覧	はい	はい
督促状への遅延料金の加算	はい	はい
入金の記録と履歴	はい	はい

上限が適用されるのは、同時に進行できる督促件数であり、督促状の数や延滞期間の集計ではありません。最初のリマインダーから最終通知まで進める延滞請求書が 3 件あれば、実用的な督促一覧になります。また、支払いが完了すると、その請求書の枠が空きます。上限が設けられているのは、対応範囲です。同時に 4 件を督促するのは回収業務にあたり、フリーランサーの月々の業務とは異なります。

Pro の購入先：https://mcp.zovo.one/buy/dunning-letters。このサーバー単体は一回限りの $19、バンドルは $39 です。

計算例

この段階設定は最終通知日ではなく支払期限を基準にしており、督促が滞ると、両者の日付は正確にずれていきます。

test/_client.mjs の督促例では、支払額は 1,250.00 USD、支払期限は 2026-06-01、間隔は 7／14／21 日なので、何も送っていなくても各通知の期限は 06-08、06-15、06-22 です。たとえば、1 回目のリマインダーを実際に送るのが遅れて 06-20 になった場合、予定日から 12 日遅れです。前回の通知を基準にする段階設定なら、最終通知は 07-11 までずれ込みます。しかし、この設定ではそうなりません。クライアントの支払い義務は、あなたが通知を書くのに取りかかった日ではなく、支払期限によって決まっているため、06-22 のままです。送信を記録すると変わるのは次の段階だけで、スケジュールは変わりません。また、通知は厳密に順番どおりです。何も送らないまま 60 日延滞している請求書でも、送るべきなのは 1 回目のリマインダーです。丁寧な通知を先に送らずに最終通知を送ると、督促ではなく脅しのように受け取られるためです。

遅延損害金も同じ方法で一度だけ計算します。30 日を 1 か月とする単利の日割りで、通知を書いた日の未払い額に対して計算し、最小通貨単位に一度だけ丸めます。督促例では、30 日の延滞に対して 125,000 の最小通貨単位に 2％を適用するため、遅延損害金は正確に 2,500 です。50,000 の一部入金後は、残額 75,000 に対して 1,500 となるため、最終通知で請求する金額は 76,500 です。これ以上の金額を作り出すことはありません。

プライバシー

すべてのデータは ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/dunning-letters/ 内にローカル保存されます。ファイルは invoices.json と counter.json の 2 つです。データが外部に送信されることはなく、アカウントも API キーも必要ありません。このサーバーはネットワーク呼び出しを一切行いません。通知は自分で送信できるようテキストとして生成され、このサーバーはメールの認証情報を保持せず、それを要求することもありません。ライセンスキーはオフラインで検証されます。

theluckystrike が開発しました。https://github.com/theluckystrike

よくある質問

支払いリマインダーや督促状に対応する MCP サーバーはありますか？

はい。mcp.zovo.one の dunning-letters サーバーは、売掛金のフォローアップを自動化します。段階的なリマインダー（丁寧、強め、最終）、印刷可能な PDF 通知、顧客ごとの延滞期間を確認できます。無料プランがあり、ホスト型のリモートエンドポイントを利用できます。

Claude から支払いリマインダーを送るにはどうすればよいですか？

https://mcp.zovo.one/mcp/dunning-letters に接続して、「延滞している請求書を一覧表示し、Acme 宛ての強めのリマインダーを作成して」と伝えてください。通知は標準の段階的な順序に沿って作成され、PDF として出力されます。

これらのドキュメントを MCP サーバーとして使用する

任意の MCP クライアント（Claude、Cursor、Windsurf、VS Code）で、インストールせずに GitMCP 経由でこのリポジトリのドキュメントを直接読み取れます。

• ドキュメント MCP URL：https://gitmcp.io/theluckystrike/mcp-dunning-letters