适合谁
- 个人用户使用 LunchMoney 管理财务，希望通过 AI 助手自动化查询和操作
- 需要将财务数据与 AI 工作流集成的开发者
- 希望快速设置和使用 MCP 服务器的用户
L
41FMRS · D
该服务器提供全面的 LunchMoney API 覆盖，但需要用户具备一定的技术知识来配置。它适合个人财务管理自动化，但需注意 token 安全性和操作风险。
这是一个用于 LunchMoney 的 Model Context Protocol (MCP) 服务器实现，提供对个人财务管理的编程访问，支持交易、预算、分类、标签、循环项目、手动账户、Plaid 账户、加密货币和余额历史记录等完整功能。它使用 LunchMoney v2 API（alpha），并采用 TOON 编码以节省 token。支持 stdio 传输，可作为 npm 包或 MCP Bundle 安装。
工具能力
get_user
获取当前用户详情。
get_all_categories
获取所有分类，支持过滤。
get_single_category
获取特定分类或分类组的详情。
create_category
创建分类或分类组。
update_category
更新分类属性；对于分类组会替换子分类列表。
delete_category
删除分类，可强制删除覆盖依赖检查。
get_all_tags
获取所有标签。
get_single_tag
按 ID 获取标签。
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
更新已删除账户的显示详细信息。
安装接入
- 获取您的 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"
}
}
}
}
选型与风险
不适合谁
- 没有 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），可能会有不稳定的变更
常见排障
- 确保 LUNCHMONEY_API_TOKEN 设置正确且有效
- 检查 Node.js 版本是否 >=16
- 如果启用调试，查看 stderr 中的日志
- 验证 MCP 客户端配置格式正确，mcpServers 部分无误
- 对于文件附件问题，确保文件扩展名和类型符合要求，大小不超过10MB
使用场景
获取账户概览和详细信息
管理分类和标签，创建分类组
查询、创建、更新、删除交易，支持批量操作和拆分
设置和跟踪预算，查看预算摘要
管理手动账户和余额历史
查看和同步 Plaid 银行账户
管理加密货币持仓和同步账户
分析支出模式，查找未分类交易
支持客户端
Claude Desktop完整支持
Claude Code完整支持
Codex CLI完整支持