zenmoney-mcp

zenmoney-mcp

面向 ZenMoney 的 MCP 服务——可通过任何兼容 MCP 的 AI 客户端（Claude Desktop、Cursor 等）访问你的个人财务数据。

功能

工具	描述
sync_data	与 ZenMoney 同步数据（首先运行）
list_accounts	列出钱包、卡片和现金账户
list_categories	按层级列出支出／收入类别
list_merchants	列出已知商家／收款方
list_transactions	列出并筛选近期交易
add_expense	添加一笔支出交易
add_income	添加一笔收入交易
add_transfer	在账户之间转账（包括跨币种转账）
update_transaction	修改现有交易——类别、金额、日期、收款方、备注、账户
suggest_category	获取针对某个收款方的自动类别建议

前提条件

• Node.js >= 18
• 一个 ZenMoney 账户
• 来自 zerro.app/token 的 API 令牌

快速开始

无需克隆或构建——只需添加到 MCP 客户端配置中：

Claude Desktop

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

{
  "mcpServers": {
    "zenmoney": {
      "command": "npx",
      "args": ["-y", "zenmoney-mcp"],
      "env": {
        "ZENMONEY_TOKEN": "your_token_here"
      }
    }
  }
}

Cursor

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "zenmoney": {
      "command": "npx",
      "args": ["-y", "zenmoney-mcp"],
      "env": {
        "ZENMONEY_TOKEN": "your_token_here"
      }
    }
  }
}

Claude Code

claude mcp add zenmoney -- npx -y zenmoney-mcp

将 your_token_here 替换为你从 zerro.app/token 获取的令牌。

Claude Desktop（MCPB bundle）

如果你希望一键安装而不编辑 JSON，可以构建一个 .mcpb bundle，然后将它拖入 Claude Desktop → 设置 → 扩展：

npm install
npm run pack:mcpb
# → dist/zenmoney-mcp-<version>.mcpb

安装时，Claude Desktop 会提示你输入 ZenMoney 令牌（存储在操作系统钥匙串中）。

从源码安装

git clone https://github.com/artarasov/zenmoney-mcp.git
cd zenmoney-mcp
npm install
npm run build
cp .env.example .env  # add your token

使用方法

配置完成后，开始对话并让 AI 客户端：

1. 首先同步——“同步我的 ZenMoney 数据”
2. 浏览——“显示我的账户”、“列出我的类别”
3. 查询——“显示过去 7 天的支出”、“列出 1 月 1 日至 31 日的交易”、“我在杂货上花了多少钱？”
4. 添加交易——“今天添加一笔 500 RUB 的咖啡支出”
5. 转账——“将 1000 USD 从 Checking 转到 Euro Card，收到 920 EUR”
6. 修正错误——“将昨天的 Amazon 支出重新分类为 Household”、“修改那笔 500 RUB 咖啡交易的备注”

list_transactions 会打印每笔交易的 ID，update_transaction 接受一个 ID 或 ID 列表，因此可以在一次调用中批量重新分类。

贡献

欢迎提交 PR！如有错误或功能请求，欢迎提出 issue。

许可证

MIT