monzo-mcp

MCP-сервер для банковского API Monzo. Доступ только для чтения к счетам, балансам, «копилкам», транзакциям и анализу расходов — всё через Claude Code или любой MCP-клиент.

В отличие от других реализаций Monzo MCP, использующих обычные bearer-токены (срок действия которых истекает через 6 часов), этот сервер поддерживает полноценный OAuth с автоматическим обновлением токенов.

Возможности

• 7 инструментов только для чтения — никаких операций записи, никаких переводов денег

• OAuth с автообновлением — токены обновляются автоматически, повторная генерация вручную не требуется

• Локальный кэш транзакций — база данных SQLite сохраняется после истечения 90-дневного окна SCA Monzo

• Анализ расходов — разбивка по категориям, топ продавцов, сравнение месяц к месяцу

• Поиск транзакций — поиск по продавцу, описанию или заметкам во всей кэшированной истории

Related MCP server: monzo-mcp

Инструменты

Предварительные требования

• Python 3.13+

• uv (рекомендуется) или pip

• Учетная запись Monzo с OAuth-клиентом, зарегистрированным на developers.monzo.com

Установка

git clone https://github.com/partymola/monzo-mcp.git
cd monzo-mcp
uv venv --python 3.13 .venv
uv pip install -e .

Настройка

1. Регистрация OAuth-клиента Monzo

Перейдите на developers.monzo.com и создайте OAuth-клиент:

• Установите URL перенаправления (redirect URL) на http://localhost:6600/callback

• Запишите свои Client ID и Client Secret

2. Аутентификация

monzo-mcp auth

Это откроет ваш браузер для OAuth Monzo. После авторизации подтвердите вход в своем приложении Monzo в течение 5 минут, чтобы получить доступ к полной истории транзакций (окно SCA Monzo).

3. Регистрация в Claude Code

claude mcp add -s user monzo -- /path/to/monzo-mcp/.venv/bin/monzo-mcp

4. Первая синхронизация

В Claude Code выполните monzo_sync, чтобы заполнить локальный кэш транзакций. Сделайте это сразу после аутентификации, чтобы воспользоваться окном SCA (до 11 месяцев истории).

Конфигурация

Вся конфигурация осуществляется через переменные окружения (необязательно):

Файлы учетных данных (создаются командой monzo-mcp auth):

• config/monzo_client.json — Client ID и Secret для OAuth

• config/monzo_tokens.json — Токены доступа и обновления (обновляются автоматически)

Окно SCA Monzo

Строгая аутентификация клиентов (SCA) Monzo ограничивает доступ к истории транзакций:

• В течение 5 минут после подтверждения в приложении: до ~11 месяцев истории

• После истечения окна: только последние 90 дней

Локальный кэш SQLite сохраняет все синхронизированные транзакции навсегда, поэтому запускайте monzo_sync сразу после monzo-mcp auth.

Безопасность

• Отсутствие инструментов записи — невозможно отправить деньги, перевести средства между «копилками» или изменить транзакции

• Сам API Monzo не может отправлять деньги на внешние счета

• Токены хранятся в виде JSON-файлов в директории config/ (добавлены в .gitignore)

• Все вызовы API являются GET-запросами с авторизацией через Bearer-токен

Участие в разработке

См. CONTRIBUTING.md для настройки среды разработки, рабочего процесса тестирования и pre-commit хуков. Изменения отслеживаются в CHANGELOG.md.

Лицензия

GPL-3.0-or-later. См. LICENSE.