MCP-сервер для Monarch Money

Сервер протокола контекста модели (MCP) для интеграции с платформой личных финансов Monarch Money через Claude Desktop.

Обзор

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

• Безопасность по умолчанию — режим «только чтение» предотвращает случайные изменения; инструменты записи требуют явного подтверждения

• Комплексность — 37 инструментов, охватывающих счета, транзакции, разделения, бюджеты, денежные потоки, теги, категории и кредитную историю

• Простота установки — расширение Claude Desktop (.mcpb), uvx или pip

Два режима работы:

Сервер по умолчанию запускается в режиме «только чтение». Инструменты записи скрыты и заблокированы, пока вы явно не разрешите их использование.

Related MCP server: Monarch Money MCP Server

Быстрый старт

Установка

Вариант 1: Расширение Claude Desktop (.mcpb) — рекомендуется для Claude Desktop

Позволяет включать/выключать режим записи прямо из приложения Claude Desktop.

1. Скачайте последний файл .mcpb из раздела Releases

2. В Claude Desktop: Settings > Extensions > Advanced Settings > Install Extensions — выберите файл .mcpb

3. Перезапустите Claude Desktop

Чтобы включить инструменты записи: Settings > Extensions > Monarch Money MCP Server > Configure — включите "Enable write tools" и нажмите Save.

Вариант 2: uvx (установка не требуется) — рекомендуется для агентов (например, Claude Code или Cursor)

Также работает с Claude Desktop, но режим записи нельзя переключить из приложения — установите его в конфигурации.

Добавьте в ваш файл конфигурации MCP:

{
  "mcpServers": {
    "Monarch Money": {
      "command": "uvx",
      "args": ["monarch-mcp"]
    }
  }
}

Чтобы включить инструменты записи:

{
  "mcpServers": {
    "Monarch Money": {
      "command": "uvx",
      "args": ["monarch-mcp", "--enable-write"]
    }
  }
}

Вариант 3: установка через pip — рекомендуется для локальной установки и venv

pip install monarch-mcp

Участникам: См. docs/releasing.md для ознакомления с процессом выпуска, схемой версий и предварительным тестированием через TestPyPI.

Добавьте в вашу конфигурацию MCP, используя полный путь к вашему интерпретатору Python:

{
  "mcpServers": {
    "Monarch Money": {
      "command": "/path/to/bin/python3",
      "args": ["-m", "monarch_mcp"]
    }
  }
}

Чтобы включить инструменты записи, добавьте "--enable-write" в args.

Вариант 4: Клонирование и установка — рекомендуется для разработки

git clone https://github.com/vargahis/monarch-mcp.git
cd monarch-mcp
pip install -e .

Затем добавьте в вашу конфигурацию MCP, используя интерпретатор Python из вашей среды разработки:

{
  "mcpServers": {
    "Monarch Money": {
      "command": "/path/to/bin/python3",
      "args": ["-m", "monarch_mcp"]
    }
  }
}

Чтобы включить инструменты записи, добавьте "--enable-write" в args.

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

Аутентификация происходит автоматически в вашем браузере при первом запуске MCP-сервера без сохраненной сессии.

1. Запустите (или перезапустите) Claude Desktop

2. Сервер обнаружит отсутствие токена и откроет страницу входа в вашем браузере

3. Введите ваш адрес электронной почты и пароль от Monarch Money

4. Введите код 2FA, если у вас включена двухфакторная аутентификация

5. После аутентификации токен будет сохранен в системной связке ключей — все готово

Ключевые детали:

• Учетные данные вводятся только в браузере — никогда через Claude Desktop

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

• Истекшие сессии проходят повторную аутентификацию автоматически — вход через браузер срабатывает при следующем вызове инструмента

• Полная поддержка MFA

• Резервный вариант: запустите python login_setup.py в терминале для headless-сред

Технические подробности архитектуры аутентификации см. в docs/authentication.md.

Примеры использования

Show me all my financial accounts

What were my last 50 transactions?

How's my budget looking this month?

Analyze my cashflow for the last 3 months

Create a tag called "Business Expenses" in red

Доступные инструменты

🙏 Благодарности

Форк monarch-mcp-server от @robcerda, поддерживаемый vargahis.

Построено на базе библиотеки Python monarchmoneycommunity.

Спасибо:

• @robcerda за оригинальный MCP-сервер

• @hammem за оригинальную библиотеку monarchmoney

• @bradleyseanf за форк сообщества

Лицензия

Лицензия MIT