personal-finance-mcp — MCP-сервер для Claude Code: личные финансы
Подключает банки, карты, кредиты и брокерские счета через Plaid к вашему ИИ-клиенту. Спрашивайте о своих деньгах обычными словами, без сторонних агрегаторов.
Открыть на GitHubЧто делает personal-finance-mcp
Сервер поднимается у вас локально и работает только на чтение: девять инструментов отдают счета, балансы, транзакции, регулярные списания, задолженности и инвестиционные позиции. Каждый ответ приходит вместе со списком предупреждений, поэтому один отвалившийся банк не ломает весь запрос.
Перед запуском нужен аккаунт Plaid на бесплатном тарифе Trial и включённые продукты Transactions, Liabilities и Investments — без них инструменты вернут пустоту, а в warnings появится PRODUCTS_NOT_SUPPORTED. Каждый банк привязывается отдельно: запускаете uvicorn link_helper:app --port 8765, проходите Plaid Link в браузере и переносите выданный токен в .env. Дальше python server.py поднимает сервер на http://localhost:8000/mcp.
Развёртывание на публичном хосте требует защиты эндпоинта: открытый /mcp с вашими токенами отдаёт доступ ко всем привязанным счетам. Автор советует OAuth 2.1, Cloudflare Access или приватную сеть. Проект не связан с Plaid Inc. и рассчитан на одного пользователя — одну установку на человека.
Какие задачи решает
- собрать общий баланс по всем привязанным счетам
- найти транзакции за период или по ключевому слову
- вычислить, какие подписки всё ещё списываются
- посмотреть APR и условия по кредиткам и займам
- проверить, какие банки требуют повторной авторизации
Примеры запросов агенту
- Покажи мой общий баланс по всем счетам
- Какие транзакции были больше 100 долларов за последние 30 дней?
- За какие подписки я до сих пор плачу?
Как установить personal-finance-mcp
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о personal-finance-mcp
Как установить personal-finance-mcp в Claude Code?
Сначала клонируйте репозиторий и подготовьте окружение: git clone https://github.com/JosueM1109/personal-finance-mcp.git, затем cd personal-finance-mcp, python3.11 -m venv .venv && source .venv/bin/activate, pip install -r requirements.txt, cp .env.example .env и заполните PLAID_CLIENT_ID с PLAID_SECRET. Привяжите банки через uvicorn link_helper:app --port 8765, запустите python server.py и добавьте сервер командой claude mcp add --transport http personal-finance http://localhost:8000/mcp.
Что делает personal-finance-mcp?
Это MCP-сервер с девятью инструментами только для чтения: счета, балансы, транзакции, поиск по ним, регулярные списания, задолженности, инвестиционные позиции и история сделок, а также статус привязки банков. Данные тянутся из Plaid по вашим ключам.
Почему инструменты возвращают пустой результат при реальных данных?
Скорее всего, при привязке банка не были включены нужные продукты Plaid. Перепривяжите банк с активными Transactions, Liabilities и Investments — в warnings такой случай помечается как PRODUCTS_NOT_SUPPORTED.
