zenmoney-mcp

MCP server wrapping the ZenMoney personal finance API.

Exposes tools (sync, read, search, write, bulk) via the Model Context Protocol over stdio, allowing LLM assistants to interact with your ZenMoney data.

Caution: Using MCP always carries a certain risk to your data, especially in the early stages of adoption. You or other users who decide to try MCP with ZenMoney may want to make backups (including daily backups to Telegram) and restore them to test accounts. See zentable.ru/backup and zentable.ru/backup/restore.

Important: When creating a test account, do it from a different phone or a cloned app. Otherwise, your bank synchronizations may break when you switch back to your main account.

Installation

Prebuilt binaries

Download the archive for your platform from the latest release, verify it against the accompanying .sha256 file, and unpack the zenmoney-mcp binary somewhere on your PATH.

With cargo-binstall:

cargo binstall zenmoney-mcp

From source

cargo install zenmoney-mcp

Getting a Token

To use this server, you need a ZenMoney API access token. You can obtain one by creating an application at ZenMoney API and following the OAuth2 flow, or by extracting the token from the ZenMoney web app (see the ZenMoney API documentation for details).

Usage

ZENMONEY_TOKEN= zenmoney-mcp

The server performs an initial sync on startup, then serves MCP tools over stdio.

Claude Desktop Integration

Add the following to your Claude Desktop config file:

{
  "mcpServers": {
    "zenmoney": {
      "command": "zenmoney-mcp",
      "env": {
        "ZENMONEY_TOKEN": "your-token-here"
      }
    }
  }
}

Replace your-token-here with your ZenMoney API token, then restart Claude Desktop.

Tools

Sync

• sync — incremental sync with ZenMoney server
• full_sync — full re-download of all data

Read

• list_accounts — list financial accounts (filter by active)