Read-only access to Quicken For Mac financial data: transactions, spending, and portfolios.
Read-only access to Quicken For Mac financial data: transactions, spending, and portfolios.
From the project's GitHub README.
An MCP server that gives Claude read-only access to your Quicken For Mac financial data. Also listed on the MCP Server Registry. Ask Claude about your accounts, transactions, spending by category, monthly trends, and more.
The database is always opened read-only — your Quicken data is never modified.
Quicken For Mac must be open while using this server. Quicken encrypts its database file when the app is closed — the data is only readable while Quicken is running.
Quicken For Mac stores data in a Core Data SQLite database inside a .quicken bundle in your Documents folder (e.g., ~/Documents/MyFinances.quicken/data). This MCP server reads that database directly and exposes 8 query tools to Claude.
claude mcp add quicken -- npx -y quicken-mac-mcp
claude plugin install quicken-mac-mcp
This installs the plugin with the MCP server and a /quicken skill that guides Claude on how to best query your data.
Download quicken-mac-mcp.mcpb from the latest GitHub release and drag it into Claude Desktop. It will prompt you for your database path (or auto-detect it).
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"quicken": {
"command": "npx",
"args": ["-y", "quicken-mac-mcp"]
}
}
}
Restart Claude Desktop and you'll see a hammer icon with 8 tools available.
If you have multiple Quicken files, or your .quicken bundle isn't in ~/Documents, set the QUICKEN_DB_PATH environment variable:
{
"mcpServers": {
"quicken": {
"command": "npx",
"args": ["-y", "quicken-mac-mcp"],
"env": {
"QUICKEN_DB_PATH": "/path/to/YourFile.quicken/data"
}
}
}
}
By default, the server auto-detects your Quicken database by picking the most recently modified .quicken bundle in ~/Documents.
| Tool | Description |
|---|---|
list_accounts | List all accounts with name, type, and active/closed status. Optional type filter. |
list_categories | List all category tags with parent hierarchy. Filter by expense/income. |
query_transactions | Query transactions with filters: date range, account types/names, amount range, payee search, category. Returns one row per split entry. |
spending_by_category | Aggregate spending by category or parent category for a date range. |
spending_over_time | Monthly spending totals, optionally broken down by category. |
search_payees | Search payees by name with transaction counts. |
list_portfolio | List investment holdings with shares, cost basis, and stored Quicken price quotes. |
raw_query | Run arbitrary SELECT queries (500-row limit). |
Quicken For Mac uses Core Data with these key tables:
| Table | Purpose |
|---|---|
ZACCOUNT | Bank accounts, credit cards, investment accounts |
ZTRANSACTION | Individual transactions |
ZCASHFLOWTRANSACTIONENTRY | Split line items (where categories live) |
ZTAG | Category tags with parent hierarchy (Z_ENT looked up at runtime) |
ZUSERPAYEE | Payee names |
Dates use Core Data epoch (seconds since 2001-01-01). The server handles all date conversion automatically — you pass ISO 8601 dates, it returns ISO 8601 dates.
Account types are stored as uppercase strings: CHECKING, CREDITCARD, SAVINGS, MORTGAGE, RETIREMENTIRA, ASSET, LIABILITY, LOAN, etc. The tools accept any casing.
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
Z_ENT lookup for CategoryTag (#4), added account_names filter and date fallback for imported transactions (#5)This project is an independent, community-developed open-source tool. It is not an official Intuit product and is not endorsed by, directly affiliated with, maintained by, or sponsored by Intuit Inc. or any of its subsidiaries. "Quicken" is a registered trademark of Intuit Inc. All product and company names are trademarks or registered trademarks of their respective holders. Use of them does not imply any affiliation with or endorsement by them.
This software is provided "as is," without warranty of any kind. The authors and contributors are not responsible for any damage, data loss, or other issues arising from its use. Always back up your financial data before using third-party tools.
MIT
Set these up before or after installing:
Environment variable: QUICKEN_DB_PATH
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-dweekly-quicken-mac-mcp": {
"env": {
"QUICKEN_DB_PATH": "your-quicken-db-path-here"
},
"args": [
"-y",
"quicken-mac-mcp"
],
"command": "npx"
}
}
}Valid MCP server (2 strong, 3 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.
8 files analyzed · 1 issue found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Be the first to review this server!
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
by mcp-marketplace · Developer Tools
Scaffold, build, and publish TypeScript MCP servers to npm — conversationally