](https://mseep.ai/app/dweekly-quicken-mac-mcp)
加快mac mcp
](https://www.npmjs.com/package/quicken-mac-mcp)  ](https://github.com/dweekly/quicken-mac-mcp/releases)  
A. 克劳德技能+MCP服务器 这使克劳德可以只读访问您的 Quicken For Mac 财务数据。询问克劳德你的账户、交易、按类别划分的支出、月度趋势、投资持有情况等。
数据库是 始终以只读方式打开 --您的Quicken数据永远不会被修改。
技能还是MCP——我想要哪一个?
此仓库提供了两个共享相同模式知识的工件(docs/schema.md):
- 技能 (
plugin/skills/quicken/SKILL.md)--教Claude直接使用sqlite3CLI。适用于Claude Code和任何其他加载技能的Claude界面。 无需安装本机模块,无需MCP服务器进程,只需SQL。 这是推荐的路径。 - MCP服务器 --将相同的SQL配方打包为八个预打包的工具(
list_accounts,query_transactions,spending_by_category, …).当您在无法加载技能的非Claude MCP客户端(Cursor、Cline、MCP远程网桥)中工作时,或者当您宁愿调用类型化工具也不愿让Claude编写SQL时,请使用它。
Claude Code插件安装(claude plugin install quicken-mac-mcp)捆包 两者,技能引导和MCP工具可作为快捷方式。
需求
Quicken For Mac必须打开 同时使用技能或MCP。Quicken在应用程序关闭时加密其数据库文件——数据只有在Quicken运行时才能读取。
运作原理
Quicken For Mac将数据存储在Core data SQLite数据库中 .quicken 在您的Documents文件夹中捆绑(例如。, ~/Documents/MyFinances.quicken/data).该技能教克劳德如何直接查询该数据库;MCP服务器是一个瘦包装器,它将八个预打包的查询作为工具公开。
安装——推荐(Claude Code,插件)
claude plugin install quicken-mac-mcp这将安装 /quicken 技能(推荐路径)和MCP服务器。克劳德将凭借其技能发挥领导作用,并在方便的时候回到MCP工具。
安装--仅MCP路径
如果您使用的是无法加载技能的非Claude Code客户端,或者您只需要键入的工具包装器,请使用这些。
克劳德代码(仅限MCP)
claude mcp add quicken -- npx -y quicken-mac-mcp克劳德桌面(MCPB拖放)
下载 quicken-mac-mcp.mcpb 从 并将其拖动到Claude Desktop中。它将提示您输入数据库路径(或自动检测)。
Claude桌面(手动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.
| 工具 | 说明 |
|---|---|
list_accounts | 列出所有帐户,包括名称、类型和活动/关闭状态。可选类型过滤器。 |
list_categories | 列出所有具有父层次结构的类别标签。按支出/收入过滤。 |
query_transactions | 使用过滤器查询交易:日期范围、账户类型/名称、金额范围、收款人搜索、类别。每个拆分条目返回一行 note (交易层面)以及 split_note (按份)备忘录。 |
spending_by_category | 按类别或父类别汇总日期范围的支出。 |
spending_over_time | 每月支出总额,可选择按类别细分。 |
search_payees | 按姓名和交易计数搜索收款人。 |
list_portfolio | 列出投资持有情况,包括股票、成本基础和存储的Quicken报价。 |
raw_query | 运行任意SELECT查询(500行限制)。 |
示例提示
- “列出我的帐户”
- “上个月我在杂货上花了多少钱?”
- “按类别显示2024年的支出”
- “在过去的一年里,我的每月支出有什么变化?”
- “查找Costco超过100美元的所有交易”
- “按交易计数,我的前10名收款人是谁?”
- “比较2024年和2025年的食品支出”
数据库模式
Quicken For Mac使用以下关键表的核心数据:
| 表 | 目的 |
|---|---|
ZACCOUNT | 银行账户、信用卡、投资账户 |
ZTRANSACTION | 个人交易(与 ZNOTE 交易级备忘录) |
ZCASHFLOWTRANSACTIONENTRY | 拆分行项目——类别和每次拆分 ZNOTE 备忘录在这里直播 |
ZTAG | 具有父层次结构的类别标签(Z_ENT在运行时查找) |
ZUSERPAYEE | 收款人姓名 |
日期使用 核心数据时代 (自2001年1月1日以来的秒数)。MCP服务器自动处理所有日期转换——您传递ISO 8601日期,它将返回ISO 8601数据。技能食谱显示了转换(+ 978307200)内联,这样克劳德就可以直接编写SQL。
帐户类型存储为大写字符串: CHECKING, CREDITCARD, SAVINGS, MORTGAGE, RETIREMENTIRA, ASSET, LIABILITY, LOAN等等。这些工具可以接受任何套管。
对于完整的模式引用(84个实体,所有表、索引、外键和核心数据写入语义包括 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 build -t quicken-mac-mcp .
docker run --rm -v ~/Documents/YourFile.quicken:/data:ro quicken-mac-mcp贡献者
免责声明
这个项目是一个独立的、社区开发的开源工具。它是 不 官方Intuit产品,不由Intuit股份有限公司或其任何子公司背书、直接附属、维护或赞助。“Quicken”是Intuit股份有限公司的注册商标。所有产品和公司名称都是其各自持有人的商标或注册商标。使用它们并不意味着与它们有任何联系或得到它们的认可。
本软件按“原样”提供,不提供任何形式的保修。作者和贡献者不对因使用而产生的任何损坏、数据丢失或其他问题负责。在使用第三方工具之前,请务必备份您的财务数据。
许可证
麻省理工学院
