ZenMoney Skill

A CLI tool for querying ZenMoney transactions locally with SQLite caching and FTS5 search.

Features

• Local SQLite cache for fast queries
• Full-text search with FTS5
• Transfer detection (excludes internal transfers from spending stats)
• Incremental sync via ZenMoney diff API
• Spending statistics by period

Structure

zenmoney-skill/
├── README.md
├── .gitignore
└── zenmoney/
    ├── SKILL.md
    ├── zenmoney.py
    └── lib/
        ├── api.py
        ├── db.py
        ├── format.py
        └── sync.py

Setup

1. Get your ZenMoney token from https://zerro.app/token

2. Set the token as environment variable:

export ZENMONEY_TOKEN="your-token-here"

3. Sync your transactions:

python3 zenmoney/zenmoney.py sync

Usage

# Show recent transactions
python3 zenmoney/zenmoney.py recent --limit 20

# Search transactions
python3 zenmoney/zenmoney.py search "coffee" --limit 10
python3 zenmoney/zenmoney.py search "grocery" --from 2026-01-01 --to 2026-01-31

# Show accounts
python3 zenmoney/zenmoney.py accounts

# Spending stats
python3 zenmoney/zenmoney.py stats --period month
python3 zenmoney/zenmoney.py stats --period week --by merchant

# Database info
python3 zenmoney/zenmoney.py info

# Purge local cache
python3 zenmoney/zenmoney.py purge --yes

Transfer Detection

The tool automatically detects and marks transfers between accounts:

• Transactions with both incomeAccount and outcomeAccount (different values)
• Paired transactions on the same date with matching amounts

Transfers are marked with [T] in output and excluded from spending statistics by default.

As Agent Skill

Following the Anthropic Agent Skills format. The zenmoney/SKILL.md file contains instructions and metadata for agent integration.