quicken-mac-mcp

这是一个 Claude Skill + MCP 服务器，让 Claude 可以只读访问您的 Quicken For Mac 财务数据。您可以向 Claude 询问您的账户、交易、按类别划分的支出、月度趋势、投资持仓等信息。

数据库始终以只读方式打开 — 您的 Quicken 数据绝不会被修改。

Skill 还是 MCP — 我该选哪个？

此仓库提供了两个共享相同模式知识（docs/schema.md）的工件：

• Skill (plugin/skills/quicken/SKILL.md) — 教导 Claude 使用 sqlite3 CLI 直接读取 Quicken SQLite 数据库。适用于 Claude Code 以及任何加载技能的 Claude 界面。无需安装原生模块，无需 MCP 服务器进程 — 只需 SQL。 这是推荐方案。

• MCP 服务器 — 将相同的 SQL 配方封装为八个预打包工具（list_accounts、query_transactions、spending_by_category 等）。当您在无法加载技能的非 Claude MCP 客户端（Cursor、Cline、mcp-remote 网桥）中工作，或者您更喜欢调用类型化工具而不是让 Claude 编写 SQL 时，请使用此方案。

Claude Code 插件安装（claude plugin install quicken-mac-mcp）会同时捆绑两者，以 Skill 为主，MCP 工具作为快捷方式提供。

Related MCP server: banktivity-mcp

要求

在使用 Skill 或 MCP 时，Quicken For Mac 必须处于打开状态。Quicken 在应用程序关闭时会加密其数据库文件 — 数据仅在 Quicken 运行时可读。

工作原理

Quicken For Mac 将数据存储在您文档文件夹中 .quicken 包内的 Core Data SQLite 数据库中（例如 ~/Documents/MyFinances.quicken/data）。Skill 教导 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 拖放)

从 GitHub 最新发布 下载 quicken-mac-mcp.mcpb 并将其拖入 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"
      }
    }
  }
}

默认情况下，服务器通过选择 ~/Documents 中最近修改的 .quicken 包来自动检测您的 Quicken 数据库。

MCP 工具

这些是 MCP 服务器公开的八个预打包工具。Skill 通过直接针对数据库编写 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 日期。Skill 配方内联显示了转换（+ 978307200），以便 Claude 可以直接编写 SQL。

账户类型存储为大写字符串：CHECKING、CREDITCARD、SAVINGS、MORTGAGE、RETIREMENTIRA、ASSET、LIABILITY、LOAN 等。工具接受任何大小写。

有关完整模式参考（84 个实体、所有表、索引、外键以及包括 Z_OPT 乐观锁在内的 Core Data 写入语义），请参阅 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 — 修复了 CategoryTag 的动态 Z_ENT 查找 (#4)，添加了 account_names 过滤器和导入交易的日期回退 (#5)

• Als-Pal — Quicken ↔ Amazon 订单匹配器 gist 指出备注存在于两个级别（ZTRANSACTION.ZNOTE 和 ZCASHFLOWTRANSACTIONENTRY.ZNOTE），并记录了现在位于 docs/schema.md 中的 Z_OPT 回写语义。

免责声明

本项目是一个独立的、社区开发的开源工具。它不是 Intuit 的官方产品，也不受 Intuit Inc. 或其任何子公司的认可、直接关联、维护或赞助。“Quicken”是 Intuit Inc. 的注册商标。所有产品和公司名称均为其各自持有者的商标或注册商标。使用它们并不意味着与它们有任何关联或得到它们的认可。

本软件按“原样”提供，不提供任何形式的保证。作者和贡献者不对因使用本软件而导致的任何损害、数据丢失或其他问题负责。在使用第三方工具之前，请务必备份您的财务数据。

许可证

MIT