← 返回目录

LunchMoney MCP Server

社区

通过 MCP 服务器管理 LunchMoney 个人财务：交易、预算、分类等。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他
Stars: ★ 109 热门
传输方式: stdio（本地进程）
运行环境: Node.js 16+
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 2 个月前
工具数: 59

41FMRS · D

该服务器提供全面的 LunchMoney API 覆盖，但需要用户具备一定的技术知识来配置。它适合个人财务管理自动化，但需注意 token 安全性和操作风险。

最强项 · 安装易用性 12/20 最弱项 · 可靠性 5/20

可靠性

5/20

安全与权限

8/20

维护活跃度

7/20

文档质量

9/20

安装易用性

12/20

查看各项评分依据

可靠性 5/20: 静态分析未提供代码、测试或 CI 配置。README 提到存在测试和 TS 源码，但本审查不执行代码，故无法验证握手或工具行为。因此，依据校准规则，可靠性得分较低。扣分原因：证据不足；未能验证实际行为。
安全与权限 8/20: README 记录了将 LUNCHMONEY_API_TOKEN 作为必需环境变量，并警示远程部署时限制附件的读取路径。未见存储的凭证、恶意网络行为或未确认的破坏性默认操作。维护者警告了远程调用可读取任意文件，因此提供了缓解建议。未发现触犯红线行为，但缺少源代码验证权限和边界。
维护活跃度 7/20: 仓库有 MIT 许可证，显示活跃开发版本 (3.0.0)。README 包含变更日志引用，但有未解决的问题。证据表明有发布和变更记录，但未提供提交/问题响应细节。因此扣分：缺少治理和响应过程的证据。
文档质量 9/20: README 内容详尽，包含安装选项、环境变量、工具列表、示例提示、远程部署、开发指引和 API 链接，并提醒破坏性变更。证据质量高。扣分：未提供故障排查/常见问题部分，且某些选项依赖外部资源。
安装易用性 12/20: 提供了清晰的多客户配置示例（Claude Code、Codex、手册）以及独立运行说明。打包为 npm 和 .mcpb。环境变量清晰。由于未执行代码，需扣分；依赖 npx 和 Node.js 要求。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件访问网络修改第三方账户数据

适合谁

个人用户使用 LunchMoney 管理财务，希望通过 AI 助手自动化查询和操作
需要将财务数据与 AI 工作流集成的开发者
希望快速设置和使用 MCP 服务器的用户

不适合谁

没有 LunchMoney 账户或 API token 的用户
需要多用户或服务端集中管理的场景（当前配置仅支持单用户）
需要 HTTP 传输且不想自己部署的用户（可通过 Cloudflare Worker 或自托管实现）

所需权限

需要 LunchMoney API token，权限范围由 token 决定，可能包括读写交易、账户、预算等
可以访问文件系统（仅用于 attach_file_to_transaction，且限制为 JPEG/PNG/HEIC/HEIF/PDF 类型）
可以访问网络以调用 LunchMoney API

风险与副作用

API token 泄露可能导致财务数据被恶意读写
工具可删除交易、账户、余额历史等，误操作可能造成数据丢失
通过 HTTP 远程部署时，如果未设置 LUNCHMONEY_ATTACHMENTS_DIR，可能导致任意文件读取风险
使用 v2 API（alpha），可能会有不稳定的变更

安装接入

准备工作

运行环境：Node.js 16+

LUNCHMONEY_API_TOKEN 必填密钥必填的 LunchMoney API 令牌，需从 https://my.lunchmoney.app/settings/developer（开发者设置页）获取。

其他可选配置项（1 个）

LUNCHMONEY_DEBUG 可选可选，设为 "true" 时会将 API 请求和响应的调试日志输出到 stderr，便于排错。

获取您的 LunchMoney API token：前往 https://my.lunchmoney.app/settings/developer 创建。
在您的 MCP 客户端中配置服务器。您可以使用 MCP Bundle（.mcpb）在 Claude Desktop 中一键安装，或使用以下命令添加：

Claude Code CLI: claude mcp add lunchmoney --transport stdio -e LUNCHMONEY_API_TOKEN=your-api-token-here -- npx -y @akutishevsky/lunchmoney-mcp
Codex CLI: codex mcp add lunchmoney --env LUNCHMONEY_API_TOKEN=your-api-token-here -- npx -y @akutishevsky/lunchmoney-mcp
手动配置：编辑客户端的配置文件，添加 mcpServers 部分，如上面 install_config 所示。

重启 MCP 客户端。
验证工具是否可用。

claude_desktop_config.json

{
  "mcpServers": {
    "lunchmoney": {
      "command": "npx",
      "args": [
        "@akutishevsky/lunchmoney-mcp"
      ],
      "env": {
        "LUNCHMONEY_API_TOKEN": "your-api-token-here",
        "LUNCHMONEY_DEBUG": "true"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "lunchmoney": {
      "command": "npx",
      "args": [
        "@akutishevsky/lunchmoney-mcp"
      ],
      "env": {
        "LUNCHMONEY_API_TOKEN": "your-api-token-here",
        "LUNCHMONEY_DEBUG": "true"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add lunchmoney -e LUNCHMONEY_API_TOKEN=your-api-token-here -e LUNCHMONEY_DEBUG=true -- npx @akutishevsky/lunchmoney-mcp

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

启动客户端后，在工具列表中应能看到 get_user、get_transactions 等工具；调用 get_user 并返回 LunchMoney 用户信息即证明连接成功。

常见排障

确保 LUNCHMONEY_API_TOKEN 设置正确且有效
检查 Node.js 版本是否 >=16
如果启用调试，查看 stderr 中的日志
验证 MCP 客户端配置格式正确，mcpServers 部分无误
对于文件附件问题，确保文件扩展名和类型符合要求，大小不超过10MB

试试这样问

连接成功后，可以直接对 AI 助手这样说：

显示我本月的预算摘要
列出上个星期的所有超过 100 美元的交易
创建一个名为 Subscriptions、月预算 100 美元的新分类
显示我所有连接的 Plaid 账户并刷新银行数据

工具能力 59

get_user 只读

获取当前用户详情。

get_all_categories 只读

获取所有分类，支持过滤。

get_single_category 只读

获取特定分类或分类组的详情。

create_category 写入

创建分类或分类组。

update_category 写入

更新分类属性；对于分类组会替换子分类列表。

delete_category 破坏性

删除分类，可强制删除覆盖依赖检查。

get_all_tags 只读

获取所有标签。

get_single_tag 只读

按 ID 获取标签。

展开其余 51 个工具

create_tag 写入

创建新标签。

update_tag 写入

更新标签属性。

delete_tag 破坏性

删除标签，可强制删除覆盖依赖。

get_transactions 只读

列出交易，支持丰富的筛选条件。

get_single_transaction 只读

获取完整交易详情，包含拆分/分组的子项。

create_transactions 写入

批量插入 1–500 笔交易。

update_transaction 写入

部分更新单笔交易。

delete_transaction 破坏性

删除单笔交易（不能是拆分/分组交易）。

update_transactions_bulk 写入

批量更新 1–500 笔交易。

delete_transactions_bulk 破坏性

按 ID 批量删除交易。

create_transaction_group 写入

从现有交易创建交易组。

delete_transaction_group 破坏性

取消交易组。

split_transaction 写入

将交易拆分为 2–500 个子项。

unsplit_transaction 写入

撤销之前的拆分。

attach_file_to_transaction 写入

上传本地文件（JPEG/PNG/HEIC/HEIF/PDF，≤10MB），验证类型。

get_transaction_attachment_url 只读

获取文件附件的签名下载 URL。

delete_transaction_attachment 破坏性

删除文件附件。

get_recurring_items 只读

获取日期范围内的循环项目，可包含系统建议。

get_single_recurring_item 只读

按 ID 获取循环项目。

get_budget_summary 只读

按分类查看预算摘要，支持各种选项。

get_budget_settings 只读

获取账户级预算周期和显示设置。

upsert_budget 写入

创建或更新分类和周期的预算。

remove_budget 破坏性

移除分类和周期的预算。

get_all_manual_accounts 只读

列出所有手动管理账户。

get_single_manual_account 只读

按 ID 获取手动账户。

create_manual_account 写入

创建新的手动账户。

update_manual_account 写入

更新手动账户属性。

delete_manual_account 破坏性

删除手动账户，可选择同时删除交易和历史记录。

get_all_plaid_accounts 只读

列出所有关联的 Plaid 账户。

get_single_plaid_account 只读

按 ID 获取 Plaid 账户。

trigger_plaid_fetch 写入

触发从 Plaid 获取最新数据。

get_supported_cryptocurrencies 只读

列出支持手动追踪的加密货币。

add_supported_cryptocurrency 写入

从 CoinGecko 币页 URL 添加支持的加密货币。

get_all_manual_crypto 只读

列出所有手动管理的加密货币余额。

get_single_manual_crypto 只读

按 ID 获取手动加密货币余额。

create_manual_crypto 写入

创建手动管理的加密货币资产。

update_manual_crypto 写入

更新手动加密货币的余额、名称等信息。

delete_manual_crypto 破坏性

删除手动加密货币资产（不可逆）。

get_all_synced_crypto 只读

列出同步的加密货币账户及其嵌套余额。

get_single_synced_crypto 只读

按 ID 获取同步加密货币账户。

get_synced_crypto_balance 只读

通过符号获取同步账户内的余额。

refresh_synced_crypto 写入

触发同步加密货币账户的余额刷新。

get_balance_history 只读

获取所有账户的月度余额历史。

get_account_balance_history 只读

获取单个账户的月度余额历史。

upsert_account_balance_history 写入

为单个账户创建或更新月度余额条目。

delete_account_balance_history 破坏性

删除单个账户的所有历史余额条目。

get_crypto_synced_balance_history 只读

获取同步加密货币持仓的月度余额历史。

upsert_crypto_synced_balance_history 写入

为同步加密货币持仓更新月度余额条目。

delete_crypto_synced_balance_history 破坏性

删除同步加密货币持仓的所有历史余额条目。

delete_balance_history_entry 破坏性

按 ID 删除单个历史余额条目。

update_deleted_account_details 写入

更新已删除账户的显示详细信息。

使用场景

获取账户概览和详细信息

管理分类和标签，创建分类组

查询、创建、更新、删除交易，支持批量操作和拆分

设置和跟踪预算，查看预算摘要

管理手动账户和余额历史

查看和同步 Plaid 银行账户

管理加密货币持仓和同步账户

分析支出模式，查找未分类交易

支持客户端

Claude Desktop

Claude Code

Codex

依据项目文档列出，未经本站实测。

详细介绍

这是一个用于 LunchMoney 的 Model Context Protocol (MCP) 服务器实现，提供对个人财务管理的编程访问，支持交易、预算、分类、标签、循环项目、手动账户、Plaid 账户、加密货币和余额历史记录等完整功能。它使用 LunchMoney v2 API（alpha），并采用 TOON 编码以节省 token。支持 stdio 传输，可作为 npm 包或 MCP Bundle 安装。