quicken-mac-mcp

Claude Skill + MCP-сервер, который предоставляет Claude доступ только для чтения к вашим финансовым данным Quicken For Mac. Спрашивайте у Claude информацию о своих счетах, транзакциях, расходах по категориям, ежемесячных тенденциях, инвестиционных портфелях и многом другом.

База данных всегда открывается только для чтения — ваши данные Quicken никогда не изменяются.

Skill или MCP — что выбрать?

Этот репозиторий содержит два артефакта, которые используют общую схему (docs/schema.md):

• Skill (plugin/skills/quicken/SKILL.md) — обучает Claude напрямую читать базу данных Quicken SQLite с помощью CLI sqlite3. Работает в Claude Code и любой другой среде Claude, поддерживающей навыки. Не требует установки нативных модулей или процесса MCP-сервера — только SQL. Это рекомендуемый путь.

• MCP-сервер — объединяет те же SQL-рецепты в восемь готовых инструментов (list_accounts, query_transactions, spending_by_category и т. д.). Используйте его, если вы работаете в MCP-клиенте, отличном от Claude (Cursor, Cline, mcp-remote bridges), который не может загружать навыки, или если вы предпочитаете вызывать типизированные инструменты, а не позволять Claude писать SQL.

Установка плагина Claude Code (claude plugin install quicken-mac-mcp) включает оба варианта, при этом навык является основным, а инструменты MCP доступны в качестве ярлыков.

Related MCP server: banktivity-mcp

Требования

Quicken For Mac должен быть открыт во время использования навыка или MCP. Quicken шифрует файл базы данных при закрытии приложения — данные доступны для чтения только во время работы Quicken.

Как это работает

Quicken For Mac хранит данные в базе данных Core Data SQLite внутри пакета .quicken в вашей папке «Документы» (например, ~/Documents/MyFinances.quicken/data). Навык обучает Claude напрямую запрашивать эту базу данных; MCP-сервер — это легкая оболочка, которая предоставляет восемь готовых запросов в виде инструментов.

Установка — рекомендуется (Claude Code, плагин)

claude plugin install quicken-mac-mcp

Это устанавливает как навык /quicken (рекомендуемый путь), так и MCP-сервер. Claude будет использовать навык в первую очередь и переключаться на инструменты MCP, когда это удобно.

Установка — только MCP

Используйте эти варианты, если вы работаете в клиенте, отличном от Claude Code, который не может загружать навыки, или если вам нужна только оболочка с типизированными инструментами.

Claude Code (только MCP)

claude mcp add quicken -- npx -y quicken-mac-mcp

Claude Desktop (перетаскивание MCPB)

Скачайте quicken-mac-mcp.mcpb из последнего релиза на GitHub и перетащите его в Claude Desktop. Он запросит путь к вашей базе данных (или определит его автоматически).

Claude Desktop (вручную через JSON)

Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "quicken": {
      "command": "npx",
      "args": ["-y", "quicken-mac-mcp"]
    }
  }
}

Перезапустите Claude Desktop, и вы увидите значок молотка с 8 доступными инструментами.

Пользовательский путь к базе данных

Если у вас несколько файлов Quicken или ваш пакет .quicken находится не в ~/Documents, установите переменную окружения QUICKEN_DB_PATH:

{
  "mcpServers": {
    "quicken": {
      "command": "npx",
      "args": ["-y", "quicken-mac-mcp"],
      "env": {
        "QUICKEN_DB_PATH": "/path/to/YourFile.quicken/data"
      }
    }
  }
}

По умолчанию сервер автоматически определяет вашу базу данных Quicken, выбирая наиболее недавно измененный пакет .quicken в ~/Documents.

Инструменты MCP

Это восемь готовых инструментов, которые предоставляет MCP-сервер. Навык охватывает тот же функционал (и даже больше), записывая SQL напрямую в базу данных — см. plugin/skills/quicken/SKILL.md.

Примеры запросов

• «Перечисли мои счета»

• «Сколько я потратил на продукты в прошлом месяце?»

• «Покажи мои расходы по категориям за 2024 год»

• «Как изменились мои ежемесячные расходы за последний год?»

• «Найди все транзакции из Costco на сумму более $100»

• «Кто мои топ-10 получателей по количеству транзакций?»

• «Сравни мои расходы на еду в 2024 и 2025 годах»

Схема базы данных

Quicken For Mac использует Core Data со следующими ключевыми таблицами:

Даты используют эпоху Core Data (секунды с 2001-01-01). MCP-сервер автоматически обрабатывает все преобразования дат — вы передаете даты в формате ISO 8601, он возвращает даты в формате ISO 8601. Рецепты навыков показывают преобразование (+ 978307200) встроенным кодом, чтобы Claude мог писать SQL напрямую.

Типы счетов хранятся как строки в верхнем регистре: CHECKING, CREDITCARD, SAVINGS, MORTGAGE, RETIREMENTIRA, ASSET, LIABILITY, LOAN и т. д. Инструменты принимают любой регистр.

Полную справку по схеме (84 сущности, все таблицы, индексы, внешние ключи и семантика записи Core Data, включая оптимистичную блокировку Z_OPT) см. в docs/schema.md.

Разработка

git clone https://github.com/dweekly/quicken-mac-mcp.git
cd quicken-mac-mcp
npm install
npm test          # run tests
npm run lint      # eslint
npm run format    # prettier
npm run dev       # run server locally

Docker

docker build -t quicken-mac-mcp .
docker run --rm -v ~/Documents/YourFile.quicken:/data:ro quicken-mac-mcp

Участники

• Manish Mukherjee — исправил динамический поиск Z_ENT для CategoryTag (#4), добавил фильтр account_names и резервный вариант даты для импортированных транзакций (#5)

• Als-Pal — gist для сопоставления заказов Quicken ↔ Amazon выявил, что заметки хранятся на двух уровнях (ZTRANSACTION.ZNOTE и ZCASHFLOWTRANSACTIONENTRY.ZNOTE), и задокументировал семантику обратной записи Z_OPT, которая теперь находится в docs/schema.md.

Отказ от ответственности

Этот проект является независимым инструментом с открытым исходным кодом, разработанным сообществом. Он не является официальным продуктом Intuit и не одобрен, не связан напрямую, не поддерживается и не спонсируется Intuit Inc. или любыми ее дочерними компаниями. «Quicken» является зарегистрированной торговой маркой Intuit Inc. Все названия продуктов и компаний являются торговыми марками или зарегистрированными торговыми марками соответствующих владельцев. Их использование не подразумевает какой-либо связи с ними или их одобрения.

Это программное обеспечение предоставляется «как есть», без каких-либо гарантий. Авторы и участники не несут ответственности за любой ущерб, потерю данных или другие проблемы, возникшие в результате его использования. Всегда делайте резервные копии своих финансовых данных перед использованием сторонних инструментов.

Лицензия

MIT