dunning-letters

逾期发票自动付款提醒

已收录于 官方 MCP Registry（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 和三个升级日期
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	查看一张追讨中发票的完整信息：付款、信件、时间表和下一步操作
invoice_delete	删除错误录入的发票。已删除的 ID 不会重新分配
license_status / license_activate	查看 Free 或 Pro 版本以及密钥

Free 与 Pro

	Free	Pro
同时追讨的未付款发票数量	3	不限
全部三封信，支持两种格式	是	是
账龄汇总和当日追讨清单	是	是
信件中的滞纳金累计	是	是
付款记录和历史记录	是	是

限制针对的是同时进行的追讨数量，而不是信件或账龄汇总：从首次提醒一直追讨到最终通知的三个逾期付款人，就能构成一份实用的追讨清单；发票一旦付款，其名额就会释放。限制的是追讨范围；同时追讨第四张发票属于催收工作量，而非自由职业者一个月的工作量。

获取 Pro：https://mcp.zovo.one/buy/dunning-letters，单独购买此服务一次性支付 $19，或购买套装支付 $39。

一个审慎的见解

提醒信的时间表以到期日为基准，而不是以上一封信为基准；只有在催收进展不顺利时，两者才会出现偏差。

test/_client.mjs 中的催收示例：应付金额为 USD 1,250.00，到期日为 2026-06-01，间隔为 7/14/21 天，因此无论是否实际寄出，提醒信的到期日都分别是 06-08、06-15 和 06-22。假设第 1 封提醒信实际直到 06-20 才寄出，比应寄日期晚了 12 天，那么以上一封信为基准的时间表会把最终通知推迟到 07-11。但本时间表不会这样：日期仍是 06-22，因为客户的付款义务由到期日确定，而不是由你何时抽空写信决定。记录寄送情况只会改变下一阶段，不会改变时间表。提醒信也严格按顺序发送：一张逾期 60 天、但此前一封信都没寄出的发票，仍应发送第 1 封提醒信，因为在没有先寄出礼貌提醒的情况下直接发最终通知，读起来像威胁，而不是催款。

滞纳金的计算方式也同样明确，一次性计算：采用单利，以 30 天为一个月按比例计算，基于写信当天的未偿金额，只在最后按最小货币单位四舍五入。按照上述催收示例，逾期 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。不会向任何地方发送数据，没有账户、没有 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