quicken-mac-mcp

Ein Claude Skill + MCP-Server, der Claude schreibgeschützten Zugriff auf Ihre Quicken For Mac-Finanzdaten gewährt. Fragen Sie Claude nach Ihren Konten, Transaktionen, Ausgaben nach Kategorien, monatlichen Trends, Anlagebeständen und mehr.

Die Datenbank wird immer schreibgeschützt geöffnet — Ihre Quicken-Daten werden niemals verändert.

Skill oder MCP — was benötige ich?

Dieses Repository enthält zwei Artefakte, die sich dasselbe Schema-Wissen teilen (docs/schema.md):

• Skill (plugin/skills/quicken/SKILL.md) — bringt Claude bei, die Quicken SQLite-Datenbank direkt mit der sqlite3 CLI zu lesen. Funktioniert in Claude Code und jeder anderen Claude-Oberfläche, die Skills lädt. Keine native Modulinstallation, kein MCP-Server-Prozess — nur SQL. Dies ist der empfohlene Weg.

• MCP-Server — kapselt dieselben SQL-Rezepte als acht vorgefertigte Tools (list_accounts, query_transactions, spending_by_category, …). Verwenden Sie ihn, wenn Sie in einem Nicht-Claude-MCP-Client arbeiten (Cursor, Cline, mcp-remote-Bridges), der keine Skills laden kann, oder wenn Sie lieber typisierte Tools aufrufen möchten, anstatt Claude SQL schreiben zu lassen.

Die Installation des Claude Code-Plugins (claude plugin install quicken-mac-mcp) bündelt beides, wobei der Skill führend ist und die MCP-Tools als Abkürzungen verfügbar sind.

Related MCP server: banktivity-mcp

Anforderungen

Quicken For Mac muss geöffnet sein, während Sie entweder den Skill oder den MCP verwenden. Quicken verschlüsselt seine Datenbankdatei, wenn die App geschlossen ist — die Daten sind nur lesbar, während Quicken läuft.

Funktionsweise

Quicken For Mac speichert Daten in einer Core Data SQLite-Datenbank innerhalb eines .quicken-Bundles in Ihrem Dokumente-Ordner (z. B. ~/Documents/MyFinances.quicken/data). Der Skill bringt Claude bei, wie diese Datenbank direkt abgefragt wird; der MCP-Server ist ein dünner Wrapper, der acht vorgefertigte Abfragen als Tools bereitstellt.

Installation — empfohlen (Claude Code, Plugin)

claude plugin install quicken-mac-mcp

Dies installiert sowohl den /quicken-Skill (empfohlener Weg) als auch den MCP-Server. Claude wird den Skill bevorzugt verwenden und bei Bedarf auf die MCP-Tools zurückgreifen.

Installation — nur MCP-Pfade

Verwenden Sie diese, wenn Sie sich in einem Client befinden, der kein Claude Code ist und keine Skills laden kann, oder wenn Sie nur den Wrapper für typisierte Tools wünschen.

Claude Code (nur MCP)

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

Claude Desktop (MCPB Drag-and-Drop)

Laden Sie quicken-mac-mcp.mcpb von der neuesten GitHub-Veröffentlichung herunter und ziehen Sie sie in Claude Desktop. Sie werden nach Ihrem Datenbankpfad gefragt (oder er wird automatisch erkannt).

Claude Desktop (manuelles JSON)

Fügen Sie dies zu ~/Library/Application Support/Claude/claude_desktop_config.json hinzu:

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

Starten Sie Claude Desktop neu und Sie sehen ein Hammer-Symbol mit 8 verfügbaren Tools.

Benutzerdefinierter Datenbankpfad

Wenn Sie mehrere Quicken-Dateien haben oder sich Ihr .quicken-Bundle nicht in ~/Documents befindet, setzen Sie die Umgebungsvariable QUICKEN_DB_PATH:

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

Standardmäßig erkennt der Server Ihre Quicken-Datenbank automatisch, indem er das zuletzt geänderte .quicken-Bundle in ~/Documents auswählt.

MCP-Tools

Dies sind die acht vorgefertigten Tools, die der MCP-Server bereitstellt. Der Skill deckt denselben Bereich (und mehr) ab, indem er SQL direkt gegen die Datenbank schreibt — siehe plugin/skills/quicken/SKILL.md.

Beispiel-Prompts

• "List my accounts"

• "What did I spend on groceries last month?"

• "Show my spending by category for 2024"

• "How has my monthly spending changed over the past year?"

• "Find all transactions from Costco over $100"

• "What are my top 10 payees by transaction count?"

• "Compare my food spending in 2024 vs 2025"

Datenbankschema

Quicken For Mac verwendet Core Data mit diesen Schlüsseltabellen:

Daten verwenden die Core Data Epoche (Sekunden seit 01.01.2001). Der MCP-Server übernimmt die gesamte Datumskonvertierung automatisch — Sie übergeben ISO 8601-Daten, er gibt ISO 8601-Daten zurück. Die Skill-Rezepte zeigen die Konvertierung (+ 978307200) inline, damit Claude SQL direkt schreiben kann.

Kontotypen werden als Strings in Großbuchstaben gespeichert: CHECKING, CREDITCARD, SAVINGS, MORTGAGE, RETIREMENTIRA, ASSET, LIABILITY, LOAN usw. Die Tools akzeptieren jede Schreibweise.

Für die vollständige Schema-Referenz (84 Entitäten, alle Tabellen, Indizes, Fremdschlüssel und Core Data Schreibsemantik einschließlich Z_OPT optimistische Sperrung), siehe docs/schema.md.

Entwicklung

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

Mitwirkende

• Manish Mukherjee — korrigierte das dynamische Z_ENT-Lookup für CategoryTag (#4), fügte account_names-Filter und Fallback-Datum für importierte Transaktionen hinzu (#5)

• Als-Pal — Quicken ↔ Amazon Bestellabgleich Gist zeigte auf, dass Notizen auf zwei Ebenen existieren (ZTRANSACTION.ZNOTE und ZCASHFLOWTRANSACTIONENTRY.ZNOTE) und dokumentierte die Z_OPT Schreib-Zurück-Semantik, die jetzt in docs/schema.md enthalten ist.

Haftungsausschluss

Dieses Projekt ist ein unabhängiges, von der Community entwickeltes Open-Source-Tool. Es ist kein offizielles Intuit-Produkt und wird nicht von Intuit Inc. oder seinen Tochtergesellschaften unterstützt, ist nicht direkt mit ihnen verbunden, wird nicht von ihnen gewartet oder gesponsert. "Quicken" ist eine eingetragene Marke von Intuit Inc. Alle Produkt- und Firmennamen sind Marken oder eingetragene Marken ihrer jeweiligen Inhaber. Die Verwendung dieser Namen impliziert keine Zugehörigkeit zu oder Unterstützung durch diese Unternehmen.

Diese Software wird "wie besehen" ohne jegliche Garantie bereitgestellt. Die Autoren und Mitwirkenden sind nicht verantwortlich für Schäden, Datenverlust oder andere Probleme, die sich aus der Verwendung ergeben. Sichern Sie Ihre Finanzdaten immer, bevor Sie Tools von Drittanbietern verwenden.

Lizenz

MIT