mcp-server-zenmoney
MCP server for ZenMoney (Дзен-мани): accounts, transactions, reports, budgets, debts for AI agents
Install / Use
claude mcp add krax1337 -- npx -y github:krax1337/mcp-server-zenmoneyIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
Finance & AccountingSupported Platforms
Tags
Our assessment of mcp-server-zenmoney
mcp-server-zenmoney scores 80/100 on our quality scale, 90th of 106 Finance & Accounting skills we index.
Its MCP Server is 18 KB long, well organised into 15 sections with 7 code examples: a thorough specification that gives an agent plenty to work with.
It has 3 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated 15 days ago, so mcp-server-zenmoney is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 87/100, with 2 cautions from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
mcp-server-zenmoney compared with similar skills
All 4 of these similar skills score higher than mcp-server-zenmoney; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| mcp-server-zenmoney (this skill)by krax1337 | 80 | 3 | 15d ago | MCP Server |
| Agent-Reachby Panniantong | 100 | 112.7k | 10d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 82.0k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.9k | today | CLAUDE.md |
| CowAgentby zhayujie | 100 | 48.0k | 1d ago | CLAUDE.md |
Frequently asked questions
- How do I install mcp-server-zenmoney?
- Run
claude mcp add krax1337 -- npx -y github:krax1337/mcp-server-zenmoney. The install tabs above show the steps for each supported agent. - Which AI agents does mcp-server-zenmoney work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is mcp-server-zenmoney safe to use?
- It is MIT-licensed and scores 87/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is mcp-server-zenmoney still maintained?
- The repository was last updated 15 days ago, so mcp-server-zenmoney is actively maintained.
Skill content
View source on GitHub💸 ZenMoney MCP
Talk to your money. Let Claude, Cursor, Codex or any MCP agent read, analyze and update your ZenMoney (Дзен-мани) finances in plain language.
</div>Example conversation:
You: How did October go? Anything unusual compared to September?
Agent: calls
summarize_transactions,get_budget→ Restaurants went 40% over budget, mostly in the last week. Taxi doubled after you started commuting by Yandex Go. Groceries were flat. Want me to raise the Restaurants budget for November or set up a category for the commute?
✨ Why
- 🔍 Ask anything. Balances, net worth, where the money went, budget status, who owes whom, what's due next week.
- ✍️ Record by talking. "Magnum 12 450 KZT from Kaspi Gold, groceries." Categories are filled in from your history, and duplicates trigger a warning.
- 📊 Budgets and reviews. Built-in
monthly_review,categorize_transactionsandplan_budgetworkflows. - 🛡️ Safe by default. Read-only mode,
dry_runpreviews, soft deletes with restore, confirmation hints on destructive tools. - 🔒 Private. Runs on your machine and talks only to the official ZenMoney API. Your token never touches disk.
Unofficial project, not affiliated with ZenMoney or Zerro.
🪄 Install with one prompt
Paste this into your coding agent (Claude Code, Codex, Cursor, omp, …):
Install the ZenMoney MCP server for me: https://github.com/krax1337/mcp-server-zenmoney
Follow the "Agent setup guide" in its README.
The agent checks Node, has you save the token to a private file (it never asks you to paste the token into chat), verifies it, and registers the server in its own config.
<details> <summary><b>🤖 Agent setup guide</b> (instructions for the AI agent doing the install)</summary>- Check that
node --versionis 22 or newer. If it isn't, stop and tell the user. - Ask the user to open https://zerro.app/token, log in with their ZenMoney account and save the token themselves with:
Do not ask for the token in chat, and do not write it into any config file.mkdir -p ~/.config && umask 077 && printf '%s' 'PASTE_TOKEN_HERE' > ~/.config/zenmoney-token - Verify the token:
ExpectZENMONEY_TOKEN_FILE=~/.config/zenmoney-token npx -y mcp-server-zenmoney --checkOK: <login>, main currency …. On exit code 1, show the user the reason and stop. - Ask the user whether the agent may change their data or should be read-only. For read-only, add
"ZENMONEY_READ_ONLY": "true"toenv(or-e ZENMONEY_READ_ONLY=truefor Claude Code). - Register the server in your own MCP config, using the absolute path of the token file:
- Claude Code:
claude mcp add zenmoney -e ZENMONEY_TOKEN_FILE=$HOME/.config/zenmoney-token -- npx -y mcp-server-zenmoney - Clients with an
mcpServersJSON file (Claude Desktop, Cursor, omp, …):"zenmoney": { "command": "npx", "args": ["-y", "mcp-server-zenmoney"], "env": { "ZENMONEY_TOKEN_FILE": "/home/<user>/.config/zenmoney-token" } }
- Claude Code:
- Tell the user to restart or reload MCP servers, then try: "Give me an overview of my finances."
🚀 Manual install
Requirements: Node.js >= 22.
- Get a token: open https://zerro.app/token, log in with your ZenMoney account and copy the token.
- Check it:
ZENMONEY_TOKEN=... npx -y mcp-server-zenmoney --checkprintsOK: <login>, main currency …, N active accounts, M transactions(exit code 1 with the reason otherwise). - Add it to your agent:
Claude Code
claude mcp add zenmoney -e ZENMONEY_TOKEN=YOUR_TOKEN -- npx -y mcp-server-zenmoney
Claude Desktop / Cursor / most MCP clients (claude_desktop_config.json, ~/.cursor/mcp.json, …)
{
"mcpServers": {
"zenmoney": {
"command": "npx",
"args": ["-y", "mcp-server-zenmoney"],
"env": { "ZENMONEY_TOKEN": "YOUR_TOKEN" }
}
}
}
omp: user-wide config ~/.omp/agent/mcp.json (or per project .omp/mcp.json), inside mcpServers:
"zenmoney": {
"type": "stdio",
"command": "npx",
"args": ["-y", "mcp-server-zenmoney"],
"env": { "ZENMONEY_TOKEN": "${ZENMONEY_TOKEN}" }
}
omp expands ${VAR} placeholders, so the token can stay in your shell environment. Then /mcp reload.
Without a token the server still starts, and every tool explains how to configure one.
Keeping the token out of config files
umask 077 && printf '%s' 'YOUR_TOKEN' > ~/.config/zenmoney-token
Then use "env": { "ZENMONEY_TOKEN_FILE": "~/.config/zenmoney-token" } instead of ZENMONEY_TOKEN.
Read-only
Add "ZENMONEY_READ_ONLY": "true" to env, or --read-only to args. Write tools are then not registered at all.
HTTP mode
ZENMONEY_TOKEN=... npx -y mcp-server-zenmoney --http --port 3000
- MCP endpoint (Streamable HTTP):
http://127.0.0.1:3000/mcp;GET /healthreturns{"ok":true}; any other path is 404. - Default bind is
127.0.0.1. Loopback binds (127.0.0.1,localhost,::1) apply Host/Origin validation against DNS rebinding. - Any other
--host/MCP_HTTP_HOSTis refused unlessMCP_HTTP_TOKENis set. When set (on any bind), clients must sendAuthorization: Bearer <MCP_HTTP_TOKEN>, otherwise they get 401. It is a single-user server: whoever has that token has your ZenMoney access, so keep it on a private network.
💬 Things to ask
- "How did October go? Biggest categories and anything unusual compared to September."
- "Add: Magnum 12 450 KZT today from Kaspi Gold, groceries."
- "Recategorize all Yandex Go rides from last month to Transport / Taxi."
- "Copy this month's budgets to next month, but raise Restaurants to 80 000."
- "Who owes me money, and how much in total?"
- "What payments are scheduled for the next two weeks?"
- "My cash wallet actually has 23 000; fix the balance."
🧰 Tools
Read (always registered, annotated readOnlyHint):
| Tool | Purpose |
| --- | --- |
| get_overview | Start here: today's date, main currency, net worth, account balances, this month's income/expenses, upcoming planned operations, data freshness |
| list_accounts | Accounts with balances (also in main currency), credit limits, bank and flags |
| list_categories | Category tree with kind (expense/income/both) and 12-month usage counts |
| list_payees | Known payees ranked by use, with last date and usual category |
| list_transactions | Filtered, paginated transaction search plus income/expense totals of all matches |
| summarize_transactions | Aggregate by category, parent category, payee, account or day/week/month/year; measure=both for cash flow |
| get_budget | Monthly budget vs. actual, remaining, % used and still-planned operations per category |
| list_planned | Planned / recurring operations still pending in a date range, with expected totals |
| list_debts | Per-person debt balances (positive = they owe you); optionally a person's debt transactions |
| suggest_category | Category/merchant suggestions for payee names from ZenMoney and your own history |
| sync | Pull changes from ZenMoney now; full=true re-downloads everything |
Write (not registered in read-only mode):
| Tool | Purpose |
| --- | --- |
| create_transactions | Record up to 50 expenses, incomes, transfers or debt operations; auto-categorizes, warns about duplicates |
| update_transactions | Edit amount, account, category, payee, comment, date, original amount; transfer destination. Type cannot change |
| delete_transactions | Soft-delete transactions by id |
| restore_transactions | Bring deleted transactions back (as copies with new ids) |
| create_category | Create a category or subcategory (one nesting level) |
| update_category | Rename, move, change kind, budget inclusion, mandatory flag, archive |
| delete_category | Delete a category, moving its transactions and planned operations to move_to or uncategorizing them |
| set_budgets | Set exact monthly budgets per category, total or uncategorized; 0 removes |
| create_account | Create a cash, card, checking or e-money account |
| update_account | Rename, archive, include/exclude from balance, savings flag, credit limit |
| adjust_account_balance | Match a real balance by recording a correction income/expense |
Write tools carry MCP annotations: creating tools are non-destructive (destructiveHint: false); editing/deleting tools are destructiveHint: true, so clients that honor hints can ask for confirmation.
create_transactions, update_transactions, delete_transactions, delete_category and set_budgets accept dry_run: true: they resolve everything and return the would-be result (for updates: before/after per transaction) without sending anything to ZenMoney.
Prompts
Clients that support MCP prompts (e.g. as slash commands) get three workflows that only orchestrate the tools above:
| Prompt | Arguments | What it does |
| --- | --- | --- |
| monthly_review | month (YYYY-MM) | Income, spending vs. previous month, budget status, large transactions, upcoming payments, suggestions |
| categorize_transactions | period | Proposes categories for uncategorized transactions, applies after confirmation (dry run first) |
| plan_budget | month (YYYY-MM) | Proposes budgets from the last three months and planned payments, applies with set_budgets after confirmation |
🔒 Data, privacy and sync
- The server keeps a local replica of your ZenMoney database, synced through the official API v8 (
POST /v8/diff/, plusPOST /v8/suggest/for categories): a full download on first use, incremental diffs afterwards. Data older thanZENMONEY_SYNC_TTLseconds is refreshed automatically before a tool runs;syncforces it. - The replica is persisted to
<cache dir>/snapshot-<hash>.json(directory created0700, file0600). The filename is a hash of token and API origin; the token itself is never written to disk. The snapshot does contain your financial data. SetZENMONEY_CACHE=offto keep everything in memory. - API origin:
https://api.zenmoney.rufirst; if it rejects the token before any request has succeeded,https://api.zenmoney.appis tried.ZENMONEY_API_URLpins a single origin. - HTTP 401 from ZenMoney means the token is no longer valid: get a fresh one at https://zerro.app/token.
- "Today" and default dates use the process time zone; set
TZ(e.g.TZ=Asia/Almaty) in the server'senvif the ag
Truncated for display — read the full file on GitHub.
Related Skills
Agent-Reach
112.7kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
82.0k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.9kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
CowAgent
48.0kOpen-source personal AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
