zenmoney-go CLI

Go-библиотека и CLI zm для ZenMoney API со скиллом Claude Code, который отвечает на вопросы о личных финансах

2 ★ репозитория
Последний коммит 5 апр. 2026

Установка

Работает в: Claude Code

Ручная установка

go install github.com/miilg/zenmoney-go/cmd/zm@latest

Устанавливает CLI zm.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

Требует токен доступа к финансовым данным
Синхронизирует данные с ZenMoney API и хранит их локально

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

CLI zm синхронизирует данные ZenMoney и показывает счета с балансами, транзакции с фильтрами по датам, счетам и категориям, дерево категорий и помесячную сводку доходов и расходов. Скилл zenmoney разрешает Claude запускать только команды zm, сам считает суммы и сравнивает периоды. Go-библиотека дает доступ к синхронизации, отправке изменений, подсказке категорий и OAuth2.

Для кого. Для пользователей ZenMoney, которые хотят спрашивать агента о своих расходах и доходах обычным языком.

Подходит, если

Нужно узнать траты по категории за месяц
Нужно сравнить доходы за разные периоды
Нужно посмотреть балансы счетов и чистый капитал

Не подходит, если

Вы не пользуетесь ZenMoney
Нужны инвестиционные рекомендации, а не учет расходов

Пример запроса к агенту

Сколько я потратил на кафе и рестораны в марте?

Ограничения

Нужны установленный Go для сборки, токен ZenMoney и zm в PATH. CLI в README описан для чтения данных, запись доступна только через библиотеку. Данные в ZenMoney попадают из банковских SMS и push-уведомлений на телефоне.

Как отключить. Удалите ~/.claude/skills/zenmoney. Сохраненный токен и данные лежат в ~/.config/zenmoney/.

Частые вопросы

Где получить токен?

На zerro.app/token или через OAuth2, описанный в разделе библиотеки.

Учитываются ли переводы между счетами?

zm summary не считает переводы доходами или расходами. Скилл также учит агента отличать переводы в списке транзакций.

Обсуждение

Вопросов и отзывов пока нет.

CLI-инструменты

Monarch Money MCP

monarch-mcp-server

Личные финансы Monarch Money для агента: счета, транзакции, бюджеты. Работает через неофициальную библиотеку сообщества, сессия в системном хранилище паролей

MCP-серверШирокий доступ426

Неофициальный read-only CLI и MCP для Т-Банка

tbank-cli-mcp

Российский стек

Локальный read-only CLI и MCP для личного кабинета Т-Банка через веб-сессию: операции, чеки и выписки, без платежей

MCP-серверШирокий доступ

The Finance Toolkit

Официальный

MCP-сервер финансового анализа: более 500 методов из отчетностей компаний, коэффициенты, индикаторы, метрики риска и макро

MCP-серверРасширенный доступ5,5 тыс.

yahoo-finance2

Неофициальный клиент Yahoo Finance с MCP-сервером, CLI и агентским скиллом: котировки, история цен, финансовые отчеты и опционы для агента

MCP-серверШирокий доступ810

CLI и MCP-сервер для 1С:Фреш

1C-Fresh: CLI и MCP

Российский стек

CLI и локальный MCP-сервер на Go для 1С:Фреш через OData: товары, цены, остатки, покупатели, заказы, продажи и деньги

MCP-серверШирокий доступ1

Claude for Financial Services CN

claude-for-financial-services-cn

Неофициальный набор из 63 скиллов для Claude Code: DCF, сравнение компаний, LBO, отчеты и деки по китайским акциям с данными Wind, iFind и AkShare

ПлагинРасширенный доступ876

Коротко о README

README описывает Go-клиент ZenMoney API и CLI zm с командами auth, sync, accounts, tx, cats и summary. Приведены три варианта подключения скилла Claude Code: личный скилл, --add-dir и скилл проекта. Раздел библиотеки показывает полную и инкрементальную синхронизацию, отправку изменений, OAuth2 и локальное хранилище. Все сущности ZenMoney API отображены в Go-структуры.

Бейдж для README

Исходный SKILL.md

---
name: zenmoney
description: Query personal finances via ZenMoney API. Use when the user asks about money, finances, accounts, balances, transactions, spending, income, expenses, budget, net worth, savings, or cash flow.
argument-hint: "[question or zm command]"
allowed-tools: Bash(zm *)
---

# ZenMoney Finance CLI

You have access to `zm` — a CLI that syncs and queries financial data from ZenMoney.

ZenMoney connects to Russian banks (Tinkoff, Sber, Alfa, etc.) and imports transactions automatically via SMS/push parsing on the user's phone. The `zm` CLI reads that data through the ZenMoney API.

## Commands

```
zm sync                   # Pull latest data (incremental)
zm sync --full            # Force full re-sync from scratch
zm accounts               # List accounts with balances and currency
zm accounts --all         # Include archived accounts
zm tx                     # Last 30 transactions
zm tx --limit N           # Last N transactions (0 = unlimited)
zm tx --from YYYY-MM-DD   # Start date filter
zm tx --to YYYY-MM-DD     # End date filter
zm tx --account "text"    # Filter by account name (case-insensitive substring)
zm tx --tag "text"        # Filter by category name (case-insensitive substring)
zm cats                   # List categories as a tree
zm summary                # Monthly income/expense/net + net worth (last 3 months)
zm summary --months N     # Last N months
```

## Workflow

1. **Sync first** — run `zm sync` before answering if you haven't synced this session.
2. **Compute** — the CLI outputs raw data. Sum totals, compute averages, compare periods, spot trends yourself.
3. **Combine commands** — a question like "how much did I spend on food in March?" needs `zm tx --tag "..." --from ... --to ... --limit 0`, then sum the outcome amounts.
4. **Transfers** — transactions with both income > 0 and outcome > 0 between different accounts are transfers, not income/expense. `zm summary` already handles this.
5. **Multi-currency** — accounts can be in different currencies (RUB, USD, USDT, etc.). The CURRENCY column in `zm accounts` shows which. `zm summary` converts to the user's base currency.

Сообщить о проблеме