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 分