zenmoney-mcp — Claude Code MCP server: what it does, how to install
Connects your ZenMoney budget to AI assistants. Lets you review past transactions, register new expenses, and adjust categories directly through chat prompts.
claude mcp add zenmoney-mcp -e ZENMONEY_TOKEN=<ZENMONEY_TOKEN> -- npx -y zenmoney-mcpWhat zenmoney-mcp does
This MCP server exposes personal accounting data from ZenMoney to language models. It provides tools to inspect balances across cards or cash accounts, navigate nested category trees, and filter transaction records across chosen timeframes.
The toolset supports logging single expenses, incomes, and cross-currency transfers between accounts. With update_transaction, you can modify details like dates, notes, or categories across multiple entries in a single step using their IDs. Payee names can also be passed to suggest_category to determine the right category automatically.
Running the server requires Node.js 18 or higher and an API key from zerro.app/token. You must run sync_data before querying records, or the server will lack current data.
What it helps with
- log daily expenses and income using natural language instructions
- reassign categories across several transactions at once
- record cross-currency transfers between personal accounts
- pull and filter transaction history for specific dates
Example prompts for the agent
- Sync my ZenMoney data and display spending from the last 7 days
- Log an expense of 500 RUB for lunch from my Cash account
- Move 1000 USD from Checking to Euro Card, receiving 920 EUR
How to install zenmoney-mcp
Platform CLI
claude mcp add zenmoney-mcp -e ZENMONEY_TOKEN=<ZENMONEY_TOKEN> -- npx -y zenmoney-mcpReplace <…> with your own values
Platform CLI
codex mcp add zenmoney-mcp --env ZENMONEY_TOKEN=<ZENMONEY_TOKEN> -- npx -y zenmoney-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"zenmoney-mcp": {
"command": "npx",
"args": [
"-y",
"zenmoney-mcp"
],
"env": {
"ZENMONEY_TOKEN": "<ZENMONEY_TOKEN>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"zenmoney-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"zenmoney-mcp"
],
"env": {
"ZENMONEY_TOKEN": "<ZENMONEY_TOKEN>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e ZENMONEY_TOKEN=<ZENMONEY_TOKEN> zenmoney-mcp npx -y zenmoney-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about zenmoney-mcp
How do I install zenmoney-mcp in Claude Code?
Run claude mcp add zenmoney-mcp -e ZENMONEY_TOKEN=<ZENMONEY_TOKEN> -- npx -y zenmoney-mcp in your terminal, replacing <ZENMONEY_TOKEN> with your authorization token.
What does zenmoney-mcp do?
It interfaces your MCP-compliant client with the ZenMoney personal finance service. You can inspect accounts, review spending logs, and create or update transactions conversationally.
What are the prerequisites for running this server?
You need Node.js version 18 or later, an active ZenMoney account, and an API secret created at zerro.app/token.
