Lunchmoney Mcp V2

lunchmoney-mcp-v2

适用于 Lunch Money API v2 的 MCP 服务。首个基于 v2 API 构建的 MCP 服务。

功能

• 14 个工具，涵盖读取、CRUD 和高级操作
• 丰富的响应数据：返回类别、标签和账户名称，而非原始 ID
• 智能缓存：启动时缓存类别、标签和账户，并在数据变更后自动刷新
• 类型安全：通过 openapi-typescript 根据官方 OpenAPI 规范生成

设置

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "lunchmoney": {
      "command": "npx",
      "args": ["lunchmoney-mcp-v2"],
      "env": {
        "LUNCHMONEY_TOKEN": "your-api-token-here"
      }
    }
  }
}

Claude Code

添加到项目中的 .mcp.json，或全局配置文件 ~/.claude/mcp.json：

{
  "mcpServers": {
    "lunchmoney": {
      "command": "npx",
      "args": ["lunchmoney-mcp-v2"],
      "env": {
        "LUNCHMONEY_TOKEN": "your-api-token-here"
      }
    }
  }
}

从 Lunch Money 开发者设置获取 API 令牌。

工具

读取

工具	描述
get_user	账户信息（姓名、邮箱、货币）
list_transactions	使用筛选条件列出或搜索交易，也可按 ID 查询
list_categories	所有类别（嵌套或平面视图）
list_tags	所有标签
get_accounts	手动账户和同步账户及其余额
get_summary	预算摘要，包含收入、支出和各类别明细
get_recurring	定期项目（订阅、账单、收入）

CRUD

工具	操作	描述
manage_transaction	create、update、delete	单笔交易操作
manage_category	create、update、delete	类别管理（强制删除时提供依赖信息）
manage_tag	create、update、delete	标签管理（强制删除时提供依赖信息）
manage_account	create、update、delete	手动账户管理（Plaid 账户为只读）

高级操作

工具	操作	描述
bulk_update_transactions	—	一次批量更新最多 500 笔交易
split_transaction	split、unsplit	将一笔交易拆分为多个部分，或恢复原交易
group_transactions	group、ungroup	将多笔交易合并为一组，或恢复原交易

示例提示词

连接后，直接用自然语言向大模型提问：

查看与整理

• “显示我本月所有尚未审核的交易”
• “将我所有的 Amazon 交易归类为购物”
• “我上周买菜花了多少钱？”
• “将这 5 笔交易标记为已审核”

预算概览

• “给我一份 1 月的支出摘要”
• “我有哪些定期支出？”
• “我每个账户里有多少钱？”

管理交易

• “添加一笔昨天在 Nobu 吃晚餐的 45 美元交易”
• “将那笔 120 美元的 Costco 交易拆分为 80 美元的食品杂货和 40 美元的家居用品”
• “将这三笔 Uber 交易合并为一组”
• “删除我刚创建的重复交易”

整理

• “创建一个名为 Side Projects 的新类别”
• “为这些交易添加 travel 标签”
• “显示我的所有类别及其 ID”
• “将 Dining Out 类别重命名为 Restaurants”

开发

npm install
npm run build
npm start

根据 OpenAPI 规范重新生成类型：

npm run generate:types

架构

src/
  index.ts          Entry point — registers tools, initializes cache
  client.ts         openapi-fetch client + error handling
  cache.ts          In-memory cache for categories, tags, accounts
  format.ts         Text formatters for all response types
  types.ts          Generated from @lunch-money/v2-api-spec
  tools/
    user.ts         get_user
    transactions.ts list_transactions, manage_transaction, bulk_update, split, group
    categories.ts   list_categories, manage_category
    tags.ts         list_tags, manage_tag
    accounts.ts     get_accounts, manage_account
    summary.ts      get_summary
    recurring.ts    get_recurring

许可证

MIT