Zenmoney Mcp

io.github.a-tarasoff由 GitHub 账号 a-tarasoff 发布v0.1.1更新于 Oct 24, 2026

MCP server for ZenMoney personal finance app

已验证STDIO仅桌面效率与工作流金融

概览

AI 生成的概览

本地 MCP 服务器，让 AI 助手访问 ZenMoney 个人财务数据，可浏览账户、交易和分类，并新增或修改记录。

可以做什么
  • 同步 ZenMoney 数据，并列出账户、分类和商户
  • 列出并筛选近期交易，可按日期范围查询
  • 新增支出、收入以及账户间转账（含跨币种）
  • 修改已有交易的分类、金额、日期、收款方、备注和账户，支持单条或批量
  • 根据收款方推荐分类
适用场景
适合用 ZenMoney 记账、希望通过对话查询支出、查看近期交易，或直接记录和重新归类账目的用户，无需在应用内手动操作。
运行要求
通过 npx 在本地运行，需要 Node.js 18 或更高版本、一个 ZenMoney 账户，以及通过环境变量 ZENMONEY_TOKEN 提供的 API 令牌。需支持桌面端 MCP 客户端（如 Claude Desktop、Cursor、Claude Code），并能访问 ZenMoney 网络服务。
安装前请注意
ZENMONEY_TOKEN 中的 ZenMoney API 令牌可访问你的财务数据，应作为机密保管。该服务器能在账户中新增和修改真实交易与转账，助手出错会直接改动账目，建议核对变更并做好备份。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Zenmoney Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

zenmoney-mcp

MCP server for ZenMoney — access your personal finance data from any MCP-compatible AI client (Claude Desktop, Cursor, etc.).

Features

ToolDescription
sync_dataSync data with ZenMoney (run first)
list_accountsList wallets, cards, and cash accounts
list_categoriesList expense/income categories with hierarchy
list_merchantsList known merchants/payees
list_transactionsList and filter recent transactions
add_expenseAdd an expense transaction
add_incomeAdd an income transaction
add_transferTransfer money between accounts (including cross-currency)
update_transactionChange an existing transaction — category, amount, date, payee, comment, account
suggest_categoryGet auto-suggested category for a payee

Prerequisites

Quick start

No cloning or building needed — just add to your MCP client config:

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Cursor

Add to .cursor/mcp.json:

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

Claude Code

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

Replace your_token_here with your token from zerro.app/token.

Claude Desktop (MCPB bundle)

If you prefer a one-click install without editing JSON, build a .mcpb bundle and drag it into Claude Desktop → Settings → Extensions:

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

On install, Claude Desktop will prompt for your ZenMoney token (stored in the OS keychain).

From source

bash
git clone https://github.com/artarasov/zenmoney-mcp.gitcd zenmoney-mcpnpm installnpm run buildcp .env.example .env  # add your token

Usage

Once configured, start a conversation and ask your AI client to:

  1. Sync first — "Sync my ZenMoney data"
  2. Browse — "Show me my accounts", "List my categories"
  3. Query — "Show expenses for the last 7 days", "List transactions from January 1–31", "How much did I spend on groceries?"
  4. Add transactions — "Add a 500 RUB expense for coffee today"
  5. Transfer — "Transfer 1000 USD from Checking to Euro Card, received 920 EUR"
  6. Fix mistakes — "Recategorize yesterday's Amazon expense to Household", "Change the comment on that 500 RUB coffee"

list_transactions prints each transaction's id, and update_transaction takes one id or a list of them — so a whole batch can be recategorized in a single call.

Contributing

PRs welcome! Feel free to open issues for bugs or feature requests.

License

MIT

来源：README.md，提交 f88e755

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分