Zen Money MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ZENMONEY_TOKEN_FILE | No | Optional path to the Zen Money access token file. By default the server reads ${HOME}/.config/zen_money_mcp/access-token. The file must be a regular file with mode 600 and must not be a symbolic link. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| sync_zenmoneyB | Синхронизировать состояние с Дзен-мани через /v8/diff/. Можно запросить полную повторную загрузку выбранных сущностей. |
| get_zenmoney_entitiesB | Получить полные исходные записи любой сущности ZenMoney API, включая reminderMarker. Используй для доступа ко всем полям и фильтров, которых нет в кратких инструментах. |
| apply_zenmoney_diffA | Полный низкоуровневый доступ к /v8/diff/: создаёт и изменяет любые поля счетов, категорий, контрагентов, бюджетов, напоминаний, маркеров напоминаний и операций; принимает массивы записей для пакетных изменений. Частичная запись объединяется с текущей, чтобы сохранить пропущенные поля. Для удаления обязательно confirmDeletes: true. Системные сущности user, instrument и company доступны только для чтения. Для бюджета передавай date первого числа месяца и tag (ID категории, null для без категории или нулевой UUID для общего бюджета). |
| get_zenmoney_profileA | Показать ID профиля и основную валюту Дзен-мани. |
| list_accountsC | Показать счета, валюты и балансы. |
| list_categoriesC | Показать категории доходов и расходов и их родительские категории. |
| list_merchantsC | Показать сохранённых контрагентов и получателей. |
| list_transactionsB | Найти операции по датам, счёту и категории; результат разбит на страницы. |
| summarize_spendingC | Свести доходы и расходы за период по валюте и категории. Валюты не складываются между собой. |
| list_budgetsB | Показать бюджеты за месяц, включая общий и безкатегорийный бюджет. |
| suggest_transactionsB | Получить подсказки Дзен-мани сразу для нескольких операций через пакетный /v8/suggest/. |
| suggest_transactionC | Запросить у Дзен-мани подсказку категории и контрагента. |
| create_transactionC | Создать расход, доход или перевод. Запишет финансовую операцию в Дзен-мани. |
| update_transactionC | Изменить сумму, дату, описание, получателя или категорию операции. |
| delete_transactionB | Пометить операцию удалённой в Дзен-мани. Изменит финансовую запись. |
| create_categoryC | Создать категорию доходов, расходов или обоих типов. |
| update_categoryC | Изменить название, родителя и настройки категории. |
| hide_categoryB | Скрыть категорию для новых операций, сохранив прошлую историю. |
| delete_categoryA | Безвозвратно удалить неиспользуемую категорию после явного подтверждения. |
| create_accountC | Создать наличный, банковский, карточный или электронный счёт. |
| update_accountC | Изменить название, учёт баланса, накопительный статус или SMS-настройки счёта. |
| archive_accountB | Архивировать счёт, сохранив его операции и историю. |
| create_merchantC | Добавить контрагента для операций и подсказок. |
| update_merchantC | Переименовать сохранённого контрагента. |
| set_budgetC | Установить месячный бюджет дохода или расхода. Изменит бюджет в Дзен-мани. |
| delete_budgetB | Убрать бюджет категории за месяц, сняв фиксацию и обнулив сумму. |
| list_instrumentsB | Показать доступные валюты и курсы. |
| list_companiesB | Показать банки и платёжные организации из Дзен-мани. |
| list_reminder_markersC | Показать конкретные запланированные операции (ReminderMarker), включая planned, processed и deleted. |
| list_remindersC | Показать запланированные операции и их состояния. |
| create_reminderC | Создать запланированный расход, доход или перевод, в том числе повторяющийся. |
| update_reminderC | Изменить сумму, счета, категорию, дату или повторение напоминания. |
| delete_reminderB | Удалить напоминание. Нужно явно подтвердить удаление. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 33 tools
Most entity-specific tools have clear boundaries, but apply_zenmoney_diff and get_zenmoney_entities overlap with nearly every create/update/list tool by offering raw access to all entities. The descriptions do explain when to use the low-level tools, which mitigates but does not eliminate the risk of misselection.
Tool names consistently use snake_case with a verb-first pattern (list_, get_, create_, update_, delete_, set_, suggest_, etc.). Domain-specific verbs like sync, apply, hide, and archive are still predictable and distinguishable.
With 33 tools, the surface is quite heavy even for a comprehensive personal finance API. Many CRUD operations could be consolidated or handled through the existing generic diff/entity tools, making the set feel bloated.
The server covers the main lifecycle for transactions, categories, accounts, budgets, and reminders, plus raw access for advanced cases. Minor gaps exist in the high-level surface, such as no dedicated merchant deletion or account deletion, but these are workable through archive or apply_zenmoney_diff.