LunchMoney MCP Server
MCP-сервер для сервиса учета личных финансов LunchMoney: транзакции, бюджеты, категории и счета доступны агенту через API v2.
- 115 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Токен открывает все финансовые данные и разрешает менять и удалять транзакции.
- Инструмент вложений читает файлы с диска, если не задана папка.
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/lunchmoney-mcp-serverОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Токен открывает все финансовые данные и разрешает менять и удалять транзакции.
- Инструмент вложений читает файлы с диска, если не задана папка.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает агента к LunchMoney и дает полный набор операций над данными учета: транзакции с фильтрами, разбивкой, группами и вложениями, категории и теги, повторяющиеся платежи, бюджеты, ручные и банковские счета Plaid, криптосчета и историю балансов. Ответы кодируются в формате TOON, который расходует меньше токенов, чем JSON. Сервер работает по stdio, есть сборка `.mcpb` для Claude Desktop. Он нацелен на LunchMoney API v2 (в статусе alpha) и проверяет входные данные до запроса: неизвестные коды валют, пустые суммы, неполные диапазоны дат.
Для кого. Пользователям LunchMoney, которые разбирают расходы и бюджеты с помощью ИИ-агента.
Подходит, если
- Агент группирует расходы за месяц по категориям и сравнивает их с бюджетом.
- Чеки к транзакциям прикрепляют из папки `~/Receipts`.
- Повторяющиеся платежи сверяют, а предложенные системой подтверждают.
- Часть транзакций надо массово переименовать или перекатегоризировать.
Не подходит, если
- Нужен совет по инвестициям: сервер работает с вашими записями, а не с рынком.
- Аккаунта LunchMoney нет, токен получить не у кого.
- Вы пользуетесь первой версией API: сервер версии 2 с ней не совместим.
Пример запроса к агенту
Покажи мои расходы за прошлый месяц по категориям и отметь категории, где бюджет превышен.MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
LUNCHMONEY_API_TOKENобязательная, секрет- Токен LunchMoney из настроек разработчика
LUNCHMONEY_DEBUG- Значение `true` включает журнал запросов и ответов в stderr
LUNCHMONEY_ATTACHMENTS_DIR- Папка, внутри которой разрешено читать вложения
Ограничения
Нужен токен LunchMoney из настроек разработчика и Node.js 16 или новее. Сервер умеет изменять и удалять транзакции, категории, теги и бюджеты, поэтому токен дает полный доступ к учету. `attach_file_to_transaction` читает файлы с диска: ограничьте папку через `LUNCHMONEY_ATTACHMENTS_DIR`, особенно при удаленном размещении. API v2 в статусе alpha, а версии 2.x, 3.x и 4.x меняли названия инструментов и параметры.
Как отключить. Удалите сервер командой `claude mcp remove lunchmoney`, либо уберите запись из конфигурации клиента, и отзовите токен в настройках разработчика LunchMoney.
Частые вопросы
Где взять токен?
В настройках разработчика LunchMoney на странице `my.lunchmoney.app/developers`. Токен передают через `LUNCHMONEY_API_TOKEN`.
Как поставить в Claude Desktop без командной строки?
Скачайте файл `.mcpb` со страницы релизов, откройте раздел Extensions и нажмите Install Extension. Токен спросят при установке.
Что делать после обновления с версии 2?
В версии 3.0.0 убран `get_all_crypto`: замените его на `get_all_manual_crypto` и `get_all_synced_crypto`. Версия 4.0.1 дополнительно отклоняет запросы, которые API все равно бы не принял.
Как включить отладочный журнал?
Задайте `LUNCHMONEY_DEBUG=true`. Запросы и ответы API пойдут в stderr.
Можно ли развернуть сервер удаленно?
Да, в README есть раздел Remote Deployments. Для такого режима обязательно ограничьте папку вложений переменной `LUNCHMONEY_ATTACHMENTS_DIR`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер к Actual Budget: агент читает счета и транзакции, строит отчеты по расходам и по флагу правит категории и правила.
Открытое приложение личных финансов со встроенным MCP-сервером: счета, бюджеты и инвестиции доступны Claude и ChatGPT
MCP-сервер к YNAB: агент читает бюджеты, счета и категории, создает и правит транзакции по личному токену, запуск через uvx.
Monarch Money MCP
monarch-mcp-server
Личные финансы Monarch Money для агента: счета, транзакции, бюджеты. Работает через неофициальную библиотеку сообщества, сессия в системном хранилище паролей
Actual MCP Server — Actual Budget для агента
Actual MCP Server
MCP-сервер на 85 инструментов для вашего Actual Budget: расходы, категории, правила и расписания по запросу агенту
Financial Datasets MCP
Financial Datasets MCP Server
MCP-сервер к API Financial Datasets: отчетность компаний, цены акций и криптовалют и новости для агента
Коротко о README
Серверная реализация MCP для LunchMoney API v2 на TypeScript с проверкой входных данных через Zod. Установка: файл `.mcpb`, команда для Claude Code или Codex, либо запись в конфигурации клиента.