quicken-mac-mcp — доступ Claude к данным Quicken для Mac
quicken-mac-mcp
Агент читает базу Quicken для Mac без права записи: счета, транзакции, траты по категориям и портфель для ответов на вопросы
- 55 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Агент получает полную историю личных счетов, транзакций и портфеля, и она уходит в контекст модели
- Инструмент raw_query исполняет произвольный SELECT по базе, хотя запись заблокирована
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/quicken-mac-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент получает полную историю личных счетов, транзакций и портфеля, и она уходит в контекст модели
- Инструмент raw_query исполняет произвольный SELECT по базе, хотя запись заблокирована
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Репозиторий выпускает два артефакта с общим знанием о схеме базы. Скилл /quicken учит Claude самому находить и читать SQLite-базу Quicken для Mac стандартной библиотекой Python 3, а справочные файлы рядом разбирают балансы, денежные потоки, инвестиции, бюджеты, теги и правила QuickFill. MCP-сервер заворачивает те же SQL-рецепты в восемь готовых инструментов: list_accounts, list_categories, query_transactions, spending_by_category, spending_over_time, search_payees, list_portfolio и raw_query. База открывается всегда только на чтение, поэтому данные Quicken агент не меняет. Запрос query_transactions фильтрует по датам, типам и именам счетов, сумме, получателю и категории и возвращает по строке на каждую часть разбивки с заметками. Сводки по тратам считают только отрицательные потребительские части и не берут переводы. Инструмент raw_query выполняет произвольный SELECT с лимитом 500 строк. Команда `qmac` в терминале вызывает те же запросы без MCP-клиента, а скрипт export_sovereign_csv.py выгружает всю историю в нормализованные CSV и файл схемы.
Для кого. Владельцам Quicken для Mac, которые хотят спрашивать Claude о своих расходах и вложениях обычными фразами, не собирая отчеты в самом приложении.
Подходит, если
- Сколько ушло на продукты в прошлом месяце, и как это соотносится с тем же месяцем прошлого года
- Нужен список всех платежей одному получателю выше заданной суммы за выбранный период
- Помесячная динамика расходов по категориям за год перед планированием бюджета
- Нужна сводка по инвестиционному портфелю: количество бумаг, базовая стоимость, валюта
- Собираетесь вынести всю историю из Quicken в CSV для собственной таблицы или другой системы
Не подходит, если
- Работаете на Windows или с Quicken для Windows: проект читает только базу версии для Mac
- Вносить, исправлять или категоризировать транзакции не получится: доступ строго на чтение
- Нужен прямой выход в банк или брокера: сервер не подключается ни к одному финансовому сервису, только к локальному файлу
- Личные финансы не должны попадать к облачной модели: данные уйдут в контекст запроса
Пример запроса к агенту
Покажи мои траты по категориям за 2024 год и найди все платежи в Costco выше 100 долларов.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
QUICKEN_DB_PATH- Путь к файлу data внутри пакета .quicken, если файлов несколько
Ограничения
Quicken для Mac должен быть открыт: у части установок программа при закрытии подменяет базу зашифрованной заглушкой. Проверялась версия 9.3.1, макет базы версии 8.5 покрыт тестовыми образцами. Для MCP-сервера и команды `qmac` нужен Node.js 22.14 или новее, скиллу хватает Python 3.
Если на компьютере несколько файлов .quicken, сервер не гадает и просит указать путь переменной QUICKEN_DB_PATH. Структура базы закрытая и от версии к версии может меняться, поэтому после обновления Quicken запросы иногда придется поправить.
Как отключить. Удалите сервер командой claude mcp `remove` quicken, а плагин командой claude plugin `uninstall` quicken-mac-mcp. Файлы Quicken остаются нетронутыми, потому что доступ был только на чтение.
Частые вопросы
Может ли Claude изменить данные в Quicken?
Нет. База открывается только на чтение, а инструмент raw_query принимает один SELECT с лимитом 500 строк. Свои записи агент не правит.
Что выбрать: скилл или MCP-сервер?
Автор рекомендует скилл: он не требует ни нативного модуля, ни отдельного процесса и работает везде, где Claude загружает скиллы. MCP-сервер нужен в Cursor, Cline и других клиентах без поддержки скиллов или когда вы хотите готовые типизированные инструменты. Плагин для Claude Code ставит оба.
Как поставить в Claude Code?
Команда claude plugin install quicken-mac-mcp ставит скилл и сервер вместе. Только сервер ставится командой claude mcp add quicken -- npx -y quicken-mac-mcp, для Claude Desktop есть пакет .mcpb для перетаскивания.
Что делать, если у меня несколько файлов Quicken?
Сервер находит базу сам, только когда файл один. Иначе он называет число найденных пакетов по каждой папке и ждет, пока вы зададите QUICKEN_DB_PATH с путем к data внутри нужного .quicken.
Как вынести историю из Quicken в таблицу?
Откройте Quicken и войдите, чтобы база расшифровалась, затем запустите python3 scripts/export_sovereign_csv.py. Скрипт создаст папку quicken_sovereign_export с accounts.csv, categories.csv, payees.csv, transactions.csv и файлом схемы.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыОфициальный локальный MCP-сервер Intuit: агент ищет и создает счета, платежи и контрагентов в QuickBooks Online, строит отчеты
Официальный MCP-сервер Xero: агент смотрит счета, контакты, проводки и отчеты в бухгалтерии, а также создает счета, платежи и табели
Учет инвестиций и расходов с встроенным MCP-сервером: агент читает портфель, а записи делает через черновики
Открытое приложение личных финансов со встроенным MCP-сервером: счета, бюджеты и инвестиции доступны Claude и ChatGPT
Financial Datasets MCP
Financial Datasets MCP Server
MCP-сервер к API Financial Datasets: отчетность компаний, цены акций и криптовалют и новости для агента
MCP дает агенту читать локальный архив китайского рынка и проверять охват, происхождение и даты финансовых данных
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| quicken-mac-mcp — доступ Claude к данным Quicken для Mac (эта карточка) | нет | не нужна | 55 | |
| Actual Budget MCP Server | нет | ключ необязателен | 286 | бюджетник Actual Budget со своим сервером, у Quicken для Mac другая локальная база |
| YNAB MCP Server | нет | API-ключ | 100 | облачный YNAB через API, здесь же файл на диске |
Коротко о README
Документация объясняет, где Quicken хранит базу: Core Data SQLite внутри пакета .quicken в Application Support, в контейнере версии из App Store или в папке, которую выбрал пользователь. Отдельные разделы описывают таблицы базы, примеры запросов и экспорт в CSV с файлом schema.json.