SkillAgentSearch skills...

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-zenmoney

If the server publishes to npm under a different name, use that package instead — check the repo README.

About this skill
🔌

MCP Server

Model Context Protocol server

Quality Score

80/100

Supported Platforms

Claude Code
Claude Desktop

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.

Substance
30/30
Structure
20/20
Description
12/15
Adoption
3/20
Freshness
15/15

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.

SkillScoreStarsUpdatedFormat
mcp-server-zenmoney (this skill)by krax133780315d agoMCP Server
Agent-Reachby Panniantong100112.7k10d agoCLAUDE.md
rufloby ruvnet10082.0ktodayCLAUDE.md
headroomby headroomlabs-ai10079.9ktodayCLAUDE.md
CowAgentby zhayujie10048.0k1d agoCLAUDE.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.
<div align="center">

💸 ZenMoney MCP

Talk to your money. Let Claude, Cursor, Codex or any MCP agent read, analyze and update your ZenMoney (Дзен-мани) finances in plain language.

CI npm MCP Registry Node License: MIT

Install in Cursor Install in VS Code

</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_transactions and plan_budget workflows.
  • 🛡️ Safe by default. Read-only mode, dry_run previews, 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>
  1. Check that node --version is 22 or newer. If it isn't, stop and tell the user.
  2. Ask the user to open https://zerro.app/token, log in with their ZenMoney account and save the token themselves with:
    mkdir -p ~/.config && umask 077 && printf '%s' 'PASTE_TOKEN_HERE' > ~/.config/zenmoney-token
    
    Do not ask for the token in chat, and do not write it into any config file.
  3. Verify the token:
    ZENMONEY_TOKEN_FILE=~/.config/zenmoney-token npx -y mcp-server-zenmoney --check
    
    Expect OK: <login>, main currency …. On exit code 1, show the user the reason and stop.
  4. Ask the user whether the agent may change their data or should be read-only. For read-only, add "ZENMONEY_READ_ONLY": "true" to env (or -e ZENMONEY_READ_ONLY=true for Claude Code).
  5. 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 mcpServers JSON file (Claude Desktop, Cursor, omp, …):
      "zenmoney": {
        "command": "npx",
        "args": ["-y", "mcp-server-zenmoney"],
        "env": { "ZENMONEY_TOKEN_FILE": "/home/<user>/.config/zenmoney-token" }
      }
      
  6. Tell the user to restart or reload MCP servers, then try: "Give me an overview of my finances."
</details>

🚀 Manual install

Requirements: Node.js >= 22.

  1. Get a token: open https://zerro.app/token, log in with your ZenMoney account and copy the token.
  2. Check it: ZENMONEY_TOKEN=... npx -y mcp-server-zenmoney --check prints OK: <login>, main currency …, N active accounts, M transactions (exit code 1 with the reason otherwise).
  3. 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 /health returns {"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_HOST is refused unless MCP_HTTP_TOKEN is set. When set (on any bind), clients must send Authorization: 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/, plus POST /v8/suggest/ for categories): a full download on first use, incremental diffs afterwards. Data older than ZENMONEY_SYNC_TTL seconds is refreshed automatically before a tool runs; sync forces it.
  • The replica is persisted to <cache dir>/snapshot-<hash>.json (directory created 0700, file 0600). 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. Set ZENMONEY_CACHE=off to keep everything in memory.
  • API origin: https://api.zenmoney.ru first; if it rejects the token before any request has succeeded, https://api.zenmoney.app is tried. ZENMONEY_API_URL pins 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's env if the ag

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars3
CategoryFinance
Updated15d ago
Forks2

Languages

TypeScript

Trust signals

87/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

2 low