Что он умеет?

Сервер управляет личными финансами через LunchMoney: читает профиль пользователя, управляет категориями, тегами и группами категорий: создаёт, обновляет, удаляет, ищет. По транзакциям делает массовые обновления и удаления, разделяет и группирует их, прикрепляет и скачивает файлы-квитанции, следит за регулярными расходами. Получает сводки и настройки бюджетов, создаёт и удаляет бюджеты. Работает с ручными и Plaid-счетами, ручными и синхронизированными криптоактивами, правит историю балансов и запускает синхронизацию.

Каталог MCP
akutishevsky/lunchmoney-mcp

akutishevsky/lunchmoney-mcp

от akutishevsky

MCP сервер для управления финансами через API LunchMoney. Открывает AI-ассистентам доступ к транзакциям, бюджетам и счетам. Автоматизация финансового учета: анализ расходов, синхронизация с банками. Работает с LunchMoney API v2.

Github NPM Сайт сервера

README

59 инструментов

Версии

Установить сервер

LunchMoney MCP Server

A Model Context Protocol (MCP) server implementation for LunchMoney, providing programmatic access to personal finance management through LunchMoney's API. Also available as an MCP Bundle (.mcpb) for easy installation in Claude Desktop.

Heads up — v3.0.0 removes get_all_crypto. The crypto tools now use LunchMoney's v2 crypto endpoints, which split manual and synced holdings into separate resources and offer no combined equivalent of v1's GET /crypto. Replace get_all_crypto with get_all_manual_crypto and get_all_synced_crypto, which together return everything it did and more. update_manual_crypto also drops its currency parameter. Nothing outside the crypto domain changed; if you don't use the crypto tools, upgrading from 2.x needs no action. See CHANGELOG.md. If you depend on get_all_crypto, pin @akutishevsky/lunchmoney-mcp@^2.2.0.

Heads up — v2.0.0 is a breaking release. This server now targets LunchMoney's v2 API (https://api.lunchmoney.dev/v2, currently in alpha). It is not backwards-compatible with v1.x of this server: tool names, fields, and endpoint shapes have changed (for example, assets is now manual_accounts, tags arrays are now tag_ids, transaction asset_id is now manual_account_id, the debit_as_negative toggle is gone, and the budget summary moved to a new /summary endpoint). See CHANGELOG.md for the full list. If you depend on v1.x, pin @akutishevsky/lunchmoney-mcp@^1.4.3.

Часто задаваемые вопросы

Инструменты были проиндексированы: 21.10.2026

add_supported_cryptocurrency

Добавляет новую криптовалюту в список поддерживаемых manual-crypto путём отправки URL её страницы монеты CoinGecko. Требуется только тогда, когда get_supported_cryptocurrencies ещё не содержит символ, который вы хотите отслеживать.

Параметры

coingecko_urlstringобязательный
URL страницы монеты на CoinGecko выглядит так: https://www.coingecko.com/{locale}/coins/{id}, например, https://www.coingecko.com/en/coins/cardano.

attach_file_to_transaction

Прикрепляет локальное изображение или PDF-квитанцию (макс. 10 МБ) к транзакции. Допустимые типы: image/jpeg, image/png, image/heic, image/heif, application/pdf. Файл считывается из локальной файловой системы хоста, на котором запущен этот MCP-сервер, а его тип определяется по фактическому содержимому — файлы, не являющиеся настоящим изображением или PDF, отклоняются. Если на хосте задана LUNCHMONEY_ATTACHMENTS_DIR, можно прикрепить только файлы из этого каталога.

Параметры

content_typeenum
Необязательное указание MIME-типа файла. Сервер всегда определяет реальный тип по содержимому файла; если это указание не совпадает с реальным типом, запрос отклоняется. Опустите этот параметр, если вам не нужна такая проверка.
file_pathstringобязательный
Абсолютный или относительный путь к файлу чека в локальной файловой системе. Это должен быть обычный файл, содержимое которого — JPEG, PNG, HEIC, HEIF или PDF. Если хост задаёт LUNCHMONEY_ATTACHMENTS_DIR, путь должен указывать внутрь этой директории.
notesstring
Необязательные примечания, описывающие вложение.
transaction_idnumberобязательный
Идентификатор транзакции, к которой нужно прикрепить файл.

create_category

Создаёт новую категорию или группу категорий. Установите is_group=true, чтобы создать группу категорий; передайте children в виде массива существующих идентификаторов категорий и/или строк (названий новых подкатегорий для создания).

Параметры

archivedboolean
Должна ли категория быть архивирована.
childrennumber | string[]
Действует только при значении is_group равном true. Массив существующих идентификаторов категорий (числа) и/или названий новых подкатегорий для создания (строки).
descriptionstring
Необязательное описание. Не более 200 символов.
exclude_from_budgetboolean
Следует ли исключать транзакции в этой категории из бюджетов.
exclude_from_totalsboolean
Следует ли исключать транзакции в этой категории из итоговых сумм.
group_idnumber
Если задано, назначает новую категорию существующей группе категорий. Не может быть задано, если is_group имеет значение true.
is_groupboolean
Если установлено значение true, создается группа категорий вместо категории. Когда значение равно true, group_id не может быть задан; используйте children для назначения существующих категорий.
is_incomeboolean
Следует ли рассматривать транзакции в этой категории как доход.
namestringобязательный
Название категории. 1-100 символов.

create_manual_account

Создаёт новый аккаунт с ручным управлением. (Ранее — create_asset.)

Параметры

balancenumberобязательный
Текущий баланс счёта.
balance_as_ofstring
Дата или дата-время, по состоянию на которое указан баланс (ISO 8601).
closed_onstring
Дата закрытия аккаунта (YYYY-MM-DD). Если задано, статус принудительно устанавливается в «закрыт».
currencystring
Трёхбуквенный код валюты в нижнем регистре (по умолчанию используется основная валюта).
display_namestring
Отображаемое имя. Если не задано, берётся из institution_name и name.
exclude_from_transactionsboolean
Если true, транзакции не могут быть назначены на этот счет.
institution_namestring
Наименование учреждения, владеющего счётом.
namestringобязательный
Название аккаунта. 1-45 символов.
subtypestring
Необязательный подтип (например, пенсионный, расчетный, сберегательный).
typeenumобязательный
Основной тип ручной учетной записи.

create_manual_crypto

Создаёт управляемый вручную криптоактив. Символ должен совпадать с одним из значений, возвращаемых функцией get_supported_cryptocurrencies.

Параметры

balancestring | numberобязательный
Баланс как числовая строка с точностью до 18 знаков после запятой, например '0.852341920145782301'. Передавайте строку, чтобы не терять точность.
display_namestring
Необязательное отображаемое имя. Если не указано, клиенты могут получить его из institution_name и name.
institution_namestring
Необязательное отображаемое имя учреждения или провайдера кошелька, например 'Ledger'.
namestringобязательный
Имя, задаваемое пользователем для ручного криптоактива, например, 'Cold Wallet BTC'.
symbolstringобязательный
Символ криптовалюты для отслеживания, например 'btc'. Должен соответствовать символу из get_supported_cryptocurrencies.

create_tag

Создаёт новый тег.

Параметры

archivedboolean
Если true, тег создается архивированным.
background_colorstring
Необязательный цвет фона тега.
descriptionstring
Необязательное описание. Не более 200 символов.
namestringобязательный
Название тега. 1-100 символов.
text_colorstring
Задает необязательный цвет текста тега.

create_transaction_group

Создаёт группу транзакций из 2-500 существующих транзакций. Исходные транзакции скрыты от get_transactions и доступны через children новой группы (установите include_children=true в get_single_transaction). Не может включать разделённые или повторяющиеся транзакции.

Параметры

category_idnumber | null
Категория для группы. Если она не задана и все дочерние элементы имеют одну категорию, группа наследует её.
datestringобязательный
Дата для новой сгруппированной транзакции (ГГГГ-ММ-ДД).
idsnumber[]обязательный
ID существующих транзакций, которые нужно сгруппировать.
notesstring | null
payeestringобязательный
Получатель для новой группированной транзакции.
statusenum
Статус для новой групповой транзакции. По умолчанию - «проверено».
tag_idsnumber[]
Идентификаторы тегов для применения к новой группе.

create_transactions

Вставляет одну или несколько транзакций (1-500 на вызов). Возвращает вставленные транзакции и все пропущенные дубликаты.

Параметры

apply_rulesboolean
Примените правила, связанные с manual_account_id транзакции.
skip_balance_updateboolean
Если это верно, не обновляйте баланс ручного счета при вставке этих транзакций.
skip_duplicatesboolean
Помечает транзакции, совпадающие с существующими по дате+получателю+сумме+счёту, как дубликаты и пропускает их. Примечание: дедупликация по external_id выполняется всегда, независимо от этого флага.
transactionsobject[]обязательный
Массив транзакций для вставки (1-500).

delete_account_balance_history

Удаляет ВСЕ исторические записи баланса для одного счета. Это необратимо и влияет на представления Net Worth. Чтобы удалить один месяц, используйте delete_balance_history_entry вместо этого.

Параметры

account_idintegerобязательный
ID аккаунта, для которого нужно удалить всю историю баланса.
account_typeenumобязательный
Тип счета, к которому относится история баланса. Используйте manual для счетов с ручным управлением, plaid для синхронизированных банковских счетов, crypto_manual для криптовалюты с ручным управлением и deleted для счетов, которые больше не существуют, но все еще имеют историю. Синхронизированная криптовалюта использует специальные инструменты crypto_synced вместо этого.

delete_balance_history_entry

Удаляет одну запись исторического баланса по её id. id должен быть получен из записи с type=historical в ответе истории баланса; временные записи current не имеют id и не могут быть удалены.

Параметры

entry_idintegerобязательный
Идентификатор исторической записи баланса для удаления. Сначала вызовите get_balance_history или get_account_balance_history, чтобы узнать идентификаторы.

delete_category

Удаляет одну категорию или группу категорий. По умолчанию завершается ошибкой (HTTP 422), если существуют зависимости, и возвращает структурированный ответ dependents. Установите force=true, чтобы удалить и отвязать от всех связанных бюджетов, транзакций, повторяющихся элементов и т. д. Принудительное удаление необратимо.

Параметры

category_idnumberобязательный
Id категории или группы категорий для удаления.
forceboolean
Если true, принудительно удаляет, даже если существуют зависимости (необратимо).

delete_crypto_synced_balance_history

Удаляет ВСЕ исторические записи баланса для синхронизированного крипто-актива. Это необратимо и влияет на представления Net Worth.

Параметры

account_idintegerобязательный
Идентификатор синхронизированного криптоаккаунта.
symbolstringобязательный
Тикер актива, историю которого нужно удалить (например, eth).

delete_manual_account

Удаляет счет, управляемый вручную. Опционально также удаляет его транзакции/правила/регулярные платежи и/или историю баланса. Оба варианта удаления необратимы.

Параметры

accountIdnumberобязательный
Идентификатор ручной учетной записи для удаления.
delete_balance_historyboolean
Если true, также удаляет любую историю баланса, связанную с этой учетной записью.
delete_itemsboolean
Если true, также удаляет все транзакции, правила и повторяющиеся элементы, связанные с этим аккаунтом.

delete_manual_crypto

Удаляет криптоактив, управляемый вручную. Если у актива есть история баланса, keep_history должен быть явно задан, иначе API отклоняет запрос. Необратимо.

Параметры

crypto_idintegerобязательный
ID вручную созданного крипто-баланса для удаления.
keep_historyboolean
Установите значение true, чтобы сохранить историю баланса, значение false, чтобы удалить её. Требуется, если у актива есть история баланса.

delete_tag

Удаляет тег. По умолчанию возвращает ошибку (HTTP 422) со структурированным ответом dependents, если тег используется в транзакциях или правилах. Установите force=true, чтобы удалить и открепить от этих записей.

Параметры

forceboolean
Если true, принудительно удаляет, даже если существуют зависимости (необратимо).
tagIdnumberобязательный
Идентификатор тега, который нужно удалить.

delete_transaction

Удаляет одну транзакцию. Завершается ошибкой для разделённых/групповых транзакций и их родителей — сначала разделите/разгруппируйте. Необратимо.

Параметры

transaction_idnumberобязательный
Идентификатор транзакции для удаления.

delete_transaction_attachment

Удаляет вложение файла транзакции. Необратимо.

Параметры

file_idnumberобязательный
Идентификатор файлового вложения для удаления.

delete_transaction_group

Удаляет (разгруппировывает) группу транзакций. Исходные дочерние транзакции остаются и возвращаются к обычным негруппированным транзакциям.

Параметры

transaction_idnumberобязательный
Идентификатор группы транзакций (родительской транзакции группы) для удаления.

delete_transactions_bulk

Массово удаляет транзакции по ID (1-500). Завершается ошибкой, если какой-либо ID - родитель разделения или группы, или часть разделения/группы; сначала разъедините или разгруппируйте их. Необратимо.

Параметры

idsnumber[]обязательный
Массив идентификаторов транзакций для удаления (1-500).

get_account_balance_historyтолько чтение

Получает историю ежемесячных балансов для одного счета. Сначала вызовите get_all_manual_accounts, get_all_plaid_accounts или get_all_manual_crypto, чтобы найти идентификаторы. Для синхронизированных криптоактивов используйте get_crypto_synced_balance_history.

Параметры

account_idintegerобязательный
Идентификатор аккаунта, для которого нужно получить историю баланса.
account_typeenumобязательный
Тип счета, к которому относится история баланса. Используйте manual для счетов с ручным управлением, plaid для синхронизированных банковских счетов, crypto_manual для криптовалюты с ручным управлением и deleted для счетов, которые больше не существуют, но все еще имеют историю. Синхронизированная криптовалюта использует специальные инструменты crypto_synced вместо этого.
end_monthany
Необязательный последний месяц диапазона, включительно, в формате ГГГГ-ММ (например, 2026-03). Не должен быть раньше start_month и не должен быть в будущем. Для одного месяца используйте то же значение, что и start_month.
start_monthstring
Необязательный первый месяц диапазона, включительно, в формате YYYY-MM (например, 2026-01). Не должен быть в будущем. Если задан, end_month также обязателен. Полная дата, например 2026-01-01, недопустима.

get_all_categoriesтолько чтение

Получает список всех категорий, связанных с учётной записью пользователя. Возвращает категории в алфавитном порядке.

Параметры

formatenum
Если flattened, возвращает единый массив категорий. Если nested, возвращает массив категорий верхнего уровня (либо группы категорий, либо категории, не входящие в группы), при этом подкатегории вложены в группу категорий под свойством children. По умолчанию используется flattened.
is_groupboolean
Если true, возвращает только группы категорий. Если false, возвращает только категории, которые не являются группами категорий.

get_all_manual_accountsтолько чтение

Получает список всех учётных записей, управляемых вручную, связанных с пользователем. (Ранее известно как assets в v1 API.)

Параметры

Без параметров.

get_all_manual_cryptoтолько чтение

Получает все вручную управляемые криптобалансы, связанные с пользователем.

Параметры

Без параметров.

get_all_plaid_accountsтолько чтение

Получает список всех учётных записей Plaid (синхронизированных), связанных с пользователем.

Параметры

Без параметров.

get_all_synced_cryptoтолько чтение

Получает все синхронизированные криптоаккаунты (Coinbase, Kraken, Ethereum кошельки) и их вложенные балансы по каждому символу. Синхронизированные аккаунты подключаются в веб-приложении Lunch Money и не могут быть созданы или изменены через API.

Параметры

Без параметров.

get_all_tagsтолько чтение

Получает список всех тегов, связанных с учётной записью пользователя.

Параметры

Без параметров.

get_balance_historyтолько чтение

Получает ежемесячную историю балансов счетов по всем счетам - данные, лежащие в основе представлений Net Worth в приложении LunchMoney. История ежемесячная. Без указания диапазона месяцев возвращает всю доступную историю плюс временную запись current для текущего месяца, которая рассчитывается по запросу и может меняться между запросами. Включаются только месяцы с данными.

Параметры

end_monthany
Необязательный последний месяц диапазона, включительно, в формате ГГГГ-ММ (например, 2026-03). Не должен быть раньше start_month и не должен быть в будущем. Для одного месяца используйте то же значение, что и start_month.
start_monthstring
Необязательный первый месяц диапазона, включительно, в формате YYYY-MM (например, 2026-01). Не должен быть в будущем. Если задан, end_month также обязателен. Полная дата, например 2026-01-01, недопустима.

get_budget_settingsтолько чтение

Получает настройки бюджетного периода и отображения для аккаунта (гранулярность, длина периода, дата привязки, предпочтение скрывать отсутствие активности, опция дохода, настройка переноса остатка в бюджет).

Параметры

Без параметров.

get_budget_summaryтолько чтение

Получает сводку бюджета пользователя за заданный диапазон дат. Возвращает итоги по категориям (other_activity, recurring_activity, budgeted, available, recurring_remaining, recurring_expected). Установите include_occurrences=true для разбивки по периодам, соответствующей периодичности бюджета счёта. (Использует конечную точку v2 GET /summary.)

Параметры

end_datestringобязательный
Конечная дата в формате YYYY-MM-DD. Для согласованных результатов используйте действительный конец бюджетного периода (например, последний день месяца).
include_exclude_from_budgetsboolean
Включайте категории с установленным флагом 'Exclude from Budgets' в возвращаемый массив категорий.
include_occurrencesboolean
Добавьте массив occurrences в каждую категорию, по одной записи на каждый бюджетный период в диапазоне.
include_past_budget_datesboolean
Включает три вхождения бюджета до start_date в occurrences. Игнорируется, если include_occurrences также не установлено в true.
include_rollover_poolboolean
Включите раздел rollover_pool, резюмирующий текущий баланс пула переноса и предыдущие корректировки.
include_totalsboolean
Включает раздел верхнего уровня totals, в котором обобщаются приток и отток по всем транзакциям в диапазоне.
start_datestringобязательный
Дата начала в формате YYYY-MM-DD. Для согласованных результатов используйте действительную дату начала бюджетного периода (например, первый день месяца).

get_crypto_synced_balance_historyтолько чтение

Получает ежемесячную историю баланса для синхронизированного криптоактива, идентифицируемого по идентификатору аккаунта и тикеру. Синхронизированный криптоактив ограничен по символу, поэтому он недоступен через get_account_balance_history.

Параметры

account_idintegerобязательный
Идентификатор синхронизированного криптоаккаунта.
end_monthany
Необязательный последний месяц диапазона, включительно, в формате ГГГГ-ММ (например, 2026-03). Не должен быть раньше start_month и не должен быть в будущем. Для одного месяца используйте то же значение, что и start_month.
start_monthstring
Необязательный первый месяц диапазона, включительно, в формате YYYY-MM (например, 2026-01). Не должен быть в будущем. Если задан, end_month также обязателен. Полная дата, например 2026-01-01, недопустима.
symbolstringобязательный
Тикер актива на счёте (например, eth).

get_recurring_itemsтолько чтение

Получает список повторяющихся элементов, ожидаемых для указанного диапазона дат. Объект matches в каждом элементе заполняется на основе запрошенного диапазона.

Параметры

end_datestring
Конец диапазона для заполнения matches (ГГГГ-ММ-ДД). Обязателен, если задан start_date.
include_suggestedboolean
Если истинно, также возвращает повторяющиеся элементы, предложенные системой и ещё не проверенные.
start_datestring
Начало диапазона, используемого для заполнения matches (ГГГГ-ММ-ДД). По умолчанию — текущий месяц. Обязательно, если задан end_date.

get_single_categoryтолько чтение

Получает подробности об отдельной категории или группе категорий, включая список дочерних категорий для групп категорий.

Параметры

categoryIdnumberобязательный
Идентификатор категории для запроса. Сначала вызовите get_all_categories, чтобы узнать идентификаторы.

get_single_manual_accountтолько чтение

Получает детали одной ручной учётной записи по ID.

Параметры

accountIdnumberобязательный
Идентификатор ручного аккаунта для запроса. Сначала вызовите get_all_manual_accounts, чтобы обнаружить идентификаторы.

get_single_manual_cryptoтолько чтение

Получает один баланс криптовалюты, управляемый вручную, по идентификатору. Сначала необходимо вызвать get_all_manual_crypto, чтобы узнать идентификаторы.

Параметры

crypto_idintegerобязательный
Идентификатор вручную созданного криптобаланса для получения.

get_single_plaid_accountтолько чтение

Получает сведения об одной (синхронизированной) учётной записи Plaid по ID.

Параметры

accountIdnumberобязательный
ID аккаунта Plaid для запроса. Сначала вызовите get_all_plaid_accounts, чтобы узнать идентификаторы.

get_single_recurring_itemтолько чтение

Извлекает один повторяющийся элемент по идентификатору. Необязательный диапазон дат заполняет объект matches.

Параметры

end_datestring
Конец диапазона для заполнения matches (ГГГГ-ММ-ДД). Обязателен, если задан start_date.
recurringIdnumberобязательный
Идентификатор повторяющегося элемента для запроса. Сначала вызовите get_recurring_items, чтобы получить идентификаторы.
start_datestring
Начало диапазона, используемого для заполнения matches (ГГГГ-ММ-ДД). По умолчанию — текущий месяц. Обязательно, если задан end_date.

get_single_synced_cryptoтолько чтение

Получает один синхронизированный криптоаккаунт и все его вложенные балансы по ID.

Параметры

crypto_idintegerобязательный
Идентификатор синхронизированного криптоаккаунта для получения.

get_single_tagтолько чтение

Получает детали одного тега по идентификатору.

Параметры

tagIdnumberобязательный
Идентификатор тега для запроса. Сначала вызовите get_all_tags, чтобы узнать их id.

get_single_transactionтолько чтение

Получает детали конкретной транзакции. Ответ всегда включает plaid_metadata, custom_metadata, files и (для родительских split или group) массив children - ни одно из этих полей не возвращается по умолчанию в get_transactions.

Параметры

transaction_idnumberобязательный
Идентификатор транзакции для получения.

get_supported_cryptocurrenciesтолько чтение

Получает список криптовалют, поддерживаемых для ручного отслеживания. Символ symbol записи из этого списка необходимо передать в create_manual_crypto.

Параметры

Без параметров.

get_synced_crypto_balanceтолько чтение

Получает отдельный баланс, хранящийся в синхронизированном криптоаккаунте, с поиском по символу криптовалюты.

Параметры

crypto_idintegerобязательный
Идентификатор синхронизированного криптоаккаунта.
symbolstringобязательный
Символ криптовалюты, хранящийся в синхронизированном аккаунте, например 'eth'.

get_transaction_attachment_urlтолько чтение

Получает кратковременный подписанный URL для скачивания вложения транзакции. Ответ содержит URL и метку времени expires_at.

Параметры

file_idnumberобязательный
Идентификатор прикрепленного файла.

get_transactionsтолько чтение

Получает транзакции, опционально отфильтрованные по диапазону дат, счёту, категории, тегу, регулярной записи, статусу и другим параметрам. Возвращает не более limit транзакций (по умолчанию 1000, максимум 2000); has_more устанавливается в ответе, когда фильтрам соответствует больше транзакций. Ожидающие и родительские/дочерние транзакции в сплитах и группах по умолчанию исключаются.

Параметры

category_idnumber
Фильтрует по идентификатору категории. Значение 0 возвращает только транзакции без категории. Совпадает как с конечными категориями, так и с группами категорий.
created_sincestring
Возвращать только транзакции, созданные после этой временной метки.
end_dateany
Конец диапазона дат. Обязательно, если задан start_date.
include_childrenboolean
Заполните массив children в родительских транзакциях групп/разбиений.
include_filesboolean
Включите массив files (метаданные вложений) в каждую транзакцию.
include_group_childrenboolean
Включите исходные транзакции, которые были объединены в группы транзакций.
include_metadataboolean
Включайте поля plaid_metadata и custom_metadata в каждую транзакцию.
include_pendingboolean
Включает импортированные ожидающие транзакции в результаты.
include_split_parentsboolean
Включает исходные родительские транзакции для разделенных транзакций.
is_group_parentboolean
Если true, возвращает только группы транзакций (родительские группы).
is_pendingboolean
Фильтрует по статусу ожидания. Когда задан, имеет приоритет над include_pending.
limitnumber
Максимальное количество транзакций для возврата (1-2000, по умолчанию 1000).
manual_account_idnumber
Фильтровать по ID мануального счета, или 0, чтобы исключить все транзакции мануальных счетов.
offsetnumber
Offset для пагинации. Используйте с has_more из предыдущего ответа.
plaid_account_idnumber
Фильтрует по ID аккаунта Plaid, или 0, чтобы исключить все транзакции аккаунтов Plaid.
recurring_idnumber
start_datestring
Начало диапазона дат. Обязательно, если задан end_date.
statusenum
tag_idnumber
updated_sinceany
Возвращайте только транзакции, обновленные после этой временной метки.

get_userтолько чтение

Получает детали о текущем пользователе.

Параметры

Без параметров.

refresh_synced_cryptoвнешний мир

Запускает обновление баланса для синхронизированного крипто-счета и возвращает обновленный счет. Обращается к внешнему крипто-провайдеру.

Параметры

crypto_idintegerобязательный
Id синхронизированного крипто-счёта для обновления.

remove_budget

Удаляет бюджет для конкретной категории и периода. Запрос идемпотентен - успешно выполняется, даже если бюджет для периода отсутствует.

Параметры

category_idnumberобязательный
ID категории для бюджета, который нужно удалить.
start_datestringобязательный
Дата начала бюджетного периода в формате ГГГГ-ММ-ДД. Должна быть действительной датой начала бюджетного периода.

split_transaction

Разделяет существующую транзакцию на 2-500 дочерних транзакций. Сумма дочерних сумм должна равняться сумме родительской. После разделения родительская транзакция скрывается из get_transactions и доступна через get_single_transaction (возвращает родительскую с children).

Параметры

child_transactionsobject[]обязательный
Дочерние элементы для создания. Сумма сумм должна равняться сумме родительского элемента.
transaction_idnumberобязательный
ID транзакции для разделения.

trigger_plaid_fetchвнешний мир

Запускает получение последних данных из Plaid. Опционально ограничивает получение диапазоном дат и/или конкретным идентификатором счёта Plaid. Примечание: Plaid требует минимальной задержки в 60 секунд между запросами на получение; получение может занимать до 5 минут.

Параметры

end_datestring
Конец диапазона дат для получения транзакций (ГГГГ-ММ-ДД). Обязателен, если задан start_date.
idnumber
Если задано, извлекается только указанный аккаунт Plaid; в противном случае извлекаются все подходящие аккаунты.
start_datestring
Начало диапазона дат для получения транзакций (ГГГГ-ММ-ДД). Обязательно, если задан end_date.

unsplit_transaction

Отменяет разделение ранее разделенной транзакции, удаляя её дочерние элементы и восстанавливая родительскую. Передайте родительский элемент (split_parent_id), а не дочерний, в качестве идентификатора пути.

Параметры

transaction_idnumberобязательный
Идентификатор ранее разделенной родительской транзакции. Используйте split_parent_id разделенной дочерней транзакции, чтобы найти его.

update_categoryидемпотентный

Обновляет свойства для существующей категории или группы категорий. Для групп категорий указание дочерних элементов заменяет полный список дочерних элементов группы. Нельзя использовать для преобразования между категорией и группой категорий.

Параметры

archivedboolean
categoryIdnumberобязательный
Идентификатор категории или группы категорий для обновления.
childrennumber | string[]
Применимо только для групп категорий. Заменяет полный список дочерних элементов группы. Существующие идентификаторы (числа) сохраняют/перемещают категории; строки создают новые подкатегории.
descriptionstring
Новое описание. До 200 символов.
exclude_from_budgetboolean
exclude_from_totalsboolean
group_idnumber | null
Перемещает эту категорию в указанную группу категорий или null для удаления из любой группы.
is_incomeboolean
namestring
Новое имя. 1-100 символов.

update_deleted_account_detailsидемпотентный

Обновляет детали отображения, показываемые для удалённого аккаунта в представлениях Net Worth. Применяется ко всем историческим записям для этого удалённого источника. Должно быть предоставлено хотя бы одно поле; передайте null, чтобы очистить поле.

Параметры

account_idintegerобязательный
deleted_account_id из записи в истории баланса, у которого тип источника - deleted.
account_typestring | null
Тип удаленного аккаунта.
display_namestring | null
Отображаемое имя для удалённой учётной записи.
institution_namestring | null
Название учреждения, в котором находился удалённый аккаунт.
maskstring | null
Последние несколько цифр номера удалённого аккаунта.
namestring | null
Официальное или полное имя удалённого аккаунта.
subtypestring | null
Подтип удалённой учётной записи.

update_manual_accountидемпотентный

Обновляет существующую учётную запись, управляемую вручную. (Ранее update_asset.)

Параметры

accountIdnumberобязательный
Id ручной учётной записи, которую нужно обновить.
balancenumber
balance_as_ofstring
closed_onstring | null
currencystring
display_namestring | null
exclude_from_transactionsboolean
institution_namestring | null
namestring
subtypestring
typeenum

update_manual_cryptoидемпотентный

Обновляет баланс криптовалюты, управляемый вручную. Должно быть указано хотя бы одно из полей: name, display_name, institution_name или balance. Символ существующего баланса изменить нельзя.

Параметры

balancestring | number
Новый баланс как числовая строка с точностью до 18 знаков после запятой. Передавайте строку, чтобы избежать потери точности.
crypto_idintegerобязательный
ID криптобаланса, введённого вручную, для обновления. Синхронизированные криптобалансы обновить нельзя.
display_namestring | null
Новое отображаемое имя для криптоактива. Передайте null, чтобы очистить его.
institution_namestring | null
Новое отображаемое имя учреждения или провайдера кошелька. Передайте null, чтобы очистить его.
namestring
Новое название для криптоактива.

update_tagидемпотентный

Обновляет свойства для существующего тега.

Параметры

archivedboolean
background_colorstring | null
descriptionstring | null
namestring
tagIdnumberобязательный
Идентификатор тега для обновления.
text_colorstring | null

update_transactionидемпотентный

Обновляет существующую транзакцию. Предоставляет любое подмножество записываемых полей напрямую (API v2 больше не оборачивает тело в обёртку transaction). Не может изменять разделённые или сгруппированные транзакции; используйте вместо этого соответствующие инструменты split/group.

Параметры

transaction_idnumberобязательный
ID транзакции для обновления.
updateobjectобязательный
Поля для обновления. Укажите хотя бы одно доступное для записи поле.
update_balanceboolean
По умолчанию true. Передайте false, чтобы пропустить обновление баланса связанного ручного счёта.

update_transactions_bulkидемпотентный

Обновляет несколько транзакций за один вызов (1-500). Каждая запись должна содержать id и хотя бы одно поле для записи. Нельзя использовать для изменения разделённых или сгруппированных транзакций.

Параметры

transactionsobject[]обязательный
Массив частичных обновлений транзакций, каждое из которых имеет ключ id.

upsert_account_balance_historyидемпотентный

Создаёт или обновляет записи истории ежемесячного баланса для одного счёта. Каждый месяц должен быть прошедшим календарным месяцем — текущий месяц рассчитывается по запросу и не может быть записан. Запрос выполняется полностью или не выполняется вовсе: если какая-либо запись не проходит проверку, ни одна из них не применяется. Ответ содержит только отправленные записи, а не полную историю счёта.

Параметры

account_idintegerобязательный
Идентификатор аккаунта, для которого записывается история баланса.
account_typeenumобязательный
Тип счета, к которому относится история баланса. Используйте manual для счетов с ручным управлением, plaid для синхронизированных банковских счетов, crypto_manual для криптовалюты с ручным управлением и deleted для счетов, которые больше не существуют, но все еще имеют историю. Синхронизированная криптовалюта использует специальные инструменты crypto_synced вместо этого.
balancesobject[]обязательный
Создает или обновляет одну или несколько записей ежемесячного баланса. Если какая-либо запись не проходит проверку, весь запрос отклоняется, и ничего не обновляется.

upsert_budgetидемпотентный

Создаёт или обновляет бюджет для категории и бюджетного периода. Значение start_date должно быть допустимой датой начала бюджетного периода для учётной записи (см. get_budget_settings).

Параметры

amountnumberобязательный
Сумма бюджета.
category_idnumberобязательный
Category ID для бюджета.
currencystring
Трёхбуквенный код валюты в нижнем регистре (по умолчанию используется основная валюта).
notesstring
Необязательные примечания для бюджетного периода.
start_datestringобязательный
Дата начала бюджетного периода в формате ГГГГ-ММ-ДД. Если дата недействительна, API возвращает предыдущую и следующую корректные даты начала.

upsert_crypto_synced_balance_historyидемпотентный

Создаёт или обновляет записи истории ежемесячного баланса для синхронизированного криптоактива. Каждый месяц должен быть прошлым календарным месяцем. Если запись устанавливает symbol, он должен совпадать с аргументом symbol. Запрос выполняется полностью или не выполняется вовсе.

Параметры

account_idintegerобязательный
Идентификатор синхронизированного криптоаккаунта.
balancesobject[]обязательный
Создает или обновляет одну или несколько записей ежемесячного баланса. Если какая-либо запись не проходит проверку, весь запрос отклоняется, и ничего не обновляется.
symbolstringобязательный
Тикер актива на счёте (например, eth).

`3.0.0`основная	03.08.2026
`2.2.0`	01.08.2026
`2.1.1`	31.05.2026
`2.1.0`	19.05.2026
`2.0.1`	30.04.2026
`2.0.0`	15.04.2026
`1.4.3`	20.03.2026
`1.4.2`	18.02.2026
`1.4.1`	17.02.2026
`1.4.0`	15.02.2026
`1.3.0`	15.02.2026
`1.2.0`	15.02.2026
`1.1.1`	15.02.2026
`1.1.0`	15.02.2026
`1.0.2`	15.02.2026
`1.0.1`	27.07.2025
`1.0.0`	27.07.2025

Выберите клиент, чтобы установить akutishevsky/lunchmoney-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "akutishevsky-lunchmoney-mcp-4jrx": {
      "command": "npx",
      "args": [
        "@akutishevsky/lunchmoney-mcp"
      ],
      "env": {
        "LUNCHMONEY_API_TOKEN": "your-api-token-here",
        "LUNCHMONEY_DEBUG": "true"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "akutishevsky-lunchmoney-mcp-4jrx": {
      "command": "npx",
      "args": [
        "@akutishevsky/lunchmoney-mcp"
      ],
      "env": {
        "LUNCHMONEY_API_TOKEN": "your-api-token-here",
        "LUNCHMONEY_DEBUG": "true"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "akutishevsky-lunchmoney-mcp-4jrx": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "@akutishevsky/lunchmoney-mcp"
      ],
      "env": {
        "LUNCHMONEY_API_TOKEN": "your-api-token-here",
        "LUNCHMONEY_DEBUG": "true"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"akutishevsky-lunchmoney-mcp-4jrx\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"@akutishevsky/lunchmoney-mcp\"],\"env\":{\"LUNCHMONEY_API_TOKEN\":\"your-api-token-here\",\"LUNCHMONEY_DEBUG\":\"true\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "akutishevsky-lunchmoney-mcp-4jrx": {
      "command": "npx",
      "args": [
        "@akutishevsky/lunchmoney-mcp"
      ],
      "env": {
        "LUNCHMONEY_API_TOKEN": "your-api-token-here",
        "LUNCHMONEY_DEBUG": "true"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add akutishevsky-lunchmoney-mcp-4jrx --env LUNCHMONEY_API_TOKEN=your-api-token-here --env LUNCHMONEY_DEBUG=true -- npx @akutishevsky/lunchmoney-mcp

Либо через JSON-конфиг:

claude mcp add-json akutishevsky-lunchmoney-mcp-4jrx "{\"command\":\"npx\",\"args\":[\"@akutishevsky/lunchmoney-mcp\"],\"env\":{\"LUNCHMONEY_API_TOKEN\":\"your-api-token-here\",\"LUNCHMONEY_DEBUG\":\"true\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add akutishevsky-lunchmoney-mcp-4jrx --env LUNCHMONEY_API_TOKEN=your-api-token-here --env LUNCHMONEY_DEBUG=true -- npx @akutishevsky/lunchmoney-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.akutishevsky-lunchmoney-mcp-4jrx]
command = "npx"
args = ["@akutishevsky/lunchmoney-mcp"]

[mcp_servers.akutishevsky-lunchmoney-mcp-4jrx.env]
LUNCHMONEY_API_TOKEN = "your-api-token-here"
LUNCHMONEY_DEBUG = "true"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите akutishevsky/lunchmoney-mcp, а в поле команды запуска — строку ниже:

npx @akutishevsky/lunchmoney-mcp

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "akutishevsky-lunchmoney-mcp-4jrx": {
      "command": "npx",
      "args": [
        "@akutishevsky/lunchmoney-mcp"
      ],
      "env": {
        "LUNCHMONEY_API_TOKEN": "your-api-token-here",
        "LUNCHMONEY_DEBUG": "true"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "akutishevsky-lunchmoney-mcp-4jrx": {
      "command": "npx",
      "args": [
        "@akutishevsky/lunchmoney-mcp"
      ],
      "env": {
        "LUNCHMONEY_API_TOKEN": "your-api-token-here",
        "LUNCHMONEY_DEBUG": "true"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например akutishevsky-lunchmoney-mcp-4jrx.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: akutishevsky-lunchmoney-mcp-4jrx
    command: npx
    args:
      - "@akutishevsky/lunchmoney-mcp"
    env:
      LUNCHMONEY_API_TOKEN: your-api-token-here
      LUNCHMONEY_DEBUG: true

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "akutishevsky-lunchmoney-mcp-4jrx": {
      "command": "npx",
      "args": [
        "@akutishevsky/lunchmoney-mcp"
      ],
      "env": {
        "LUNCHMONEY_API_TOKEN": "your-api-token-here",
        "LUNCHMONEY_DEBUG": "true"
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "@akutishevsky/lunchmoney-mcp"
  ],
  "env": {
    "LUNCHMONEY_API_TOKEN": "your-api-token-here",
    "LUNCHMONEY_DEBUG": "true"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx