{
  "markdown": "# zenmoney-mcp\n\nMCP server for [ZenMoney](https://zenmoney.ru) — access your personal finance data from any MCP-compatible AI client (Claude Desktop, Cursor, etc.).\n\n## Features\n\n| Tool | Description |\n|------|-------------|\n| `sync_data` | Sync data with ZenMoney (run first) |\n| `list_accounts` | List wallets, cards, and cash accounts |\n| `list_categories` | List expense/income categories with hierarchy |\n| `list_merchants` | List known merchants/payees |\n| `list_transactions` | List and filter recent transactions |\n| `add_expense` | Add an expense transaction |\n| `add_income` | Add an income transaction |\n| `add_transfer` | Transfer money between accounts (including cross-currency) |\n| `update_transaction` | Change an existing transaction — category, amount, date, payee, comment, account |\n| `suggest_category` | Get auto-suggested category for a payee |\n\n## Prerequisites\n\n- Node.js >= 18\n- A [ZenMoney](https://zenmoney.ru) account\n- API token from [zerro.app/token](https://zerro.app/token)\n\n## Quick start\n\nNo cloning or building needed — just add to your MCP client config:\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"zenmoney\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"zenmoney-mcp\"],\n      \"env\": {\n        \"ZENMONEY_TOKEN\": \"your_token_here\"\n      }\n    }\n  }\n}\n```\n\n### Cursor\n\nAdd to `.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"zenmoney\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"zenmoney-mcp\"],\n      \"env\": {\n        \"ZENMONEY_TOKEN\": \"your_token_here\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\n```bash\nclaude mcp add zenmoney -- npx -y zenmoney-mcp\n```\n\nReplace `your_token_here` with your token from [zerro.app/token](https://zerro.app/token).\n\n### Claude Desktop (MCPB bundle)\n\nIf you prefer a one-click install without editing JSON, build a `.mcpb` bundle and drag it into Claude Desktop → Settings → Extensions:\n\n```bash\nnpm install\nnpm run pack:mcpb\n# → dist/zenmoney-mcp-<version>.mcpb\n```\n\nOn install, Claude Desktop will prompt for your ZenMoney token (stored in the OS keychain).\n\n### From source\n\n```bash\ngit clone https://github.com/artarasov/zenmoney-mcp.git\ncd zenmoney-mcp\nnpm install\nnpm run build\ncp .env.example .env  # add your token\n```\n\n## Usage\n\nOnce configured, start a conversation and ask your AI client to:\n\n1. **Sync first** — \"Sync my ZenMoney data\"\n2. **Browse** — \"Show me my accounts\", \"List my categories\"\n3. **Query** — \"Show expenses for the last 7 days\", \"List transactions from January 1–31\", \"How much did I spend on groceries?\"\n4. **Add transactions** — \"Add a 500 RUB expense for coffee today\"\n5. **Transfer** — \"Transfer 1000 USD from Checking to Euro Card, received 920 EUR\"\n6. **Fix mistakes** — \"Recategorize yesterday's Amazon expense to Household\", \"Change the comment on that 500 RUB coffee\"\n\n`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.\n\n## Contributing\n\nPRs welcome! Feel free to open issues for bugs or feature requests.\n\n## License\n\n[MIT](LICENSE)\n",
  "bytes": 3218,
  "sha": "bcfdf33debcb2061cfd4a714b74536388710587167792d45551911058e331865",
  "repo_slug": "a-tarasoff/zenmoney-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_a_tarasoff_zenmoney_mcp_13a2a14b/readme"
}