Copilot Money MCP-Server

Analysieren und verwalten Sie Ihre persönlichen Finanzen mit KI unter Verwendung lokaler Copilot Money-Daten

Haftungsausschluss

Dies ist ein unabhängiges, von der Community betriebenes Projekt und steht in keinerlei Verbindung zu Copilot Money oder dessen Muttergesellschaft, wird von diesen nicht unterstützt oder assoziiert. Dieses Tool wurde von einem unabhängigen Entwickler erstellt, um KI-gestützte Abfragen lokal zwischengespeicherter Daten zu ermöglichen. "Copilot Money" ist eine Marke des jeweiligen Eigentümers.

Übersicht

Ein MCP-Server, der KI-Assistenten Zugriff auf Ihre persönlichen Finanzdaten von Copilot Money gewährt. Er liest aus der lokal zwischengespeicherten Firestore-Datenbank (LevelDB + Protocol Buffers) auf Ihrem Mac. Lesezugriffe erfolgen zu 100 % lokal ohne Netzwerkanfragen. Ein optionaler Schreibmodus (aktivierbar über --write) sendet Ihre angeforderten Änderungen direkt an das Firebase/Firestore-Backend von Copilot Money – dasselbe Backend, das auch die Copilot Money-App selbst verwendet – authentifiziert mit Ihren eigenen Anmeldedaten, niemals über einen Drittanbieter-Dienst.

35 Werkzeuge für Ausgaben, Investitionen, Budgets, Ziele und mehr:

• 17 Lese-Werkzeuge – Abfrage von Transaktionen, Konten, Beständen, Salden, Kategorien, wiederkehrenden Zahlungen, Budgets, Zielen, Anlageperformance und mehr

• 18 Schreib-Werkzeuge (optional) – Zusammenführen von Transaktionsänderungen, Verwalten von Tags, Erstellen von Budgets, Aktualisieren wiederkehrender Posten und Organisieren Ihrer Finanzen

Standardmäßig schreibgeschützt. Schreib-Werkzeuge erfordern das explizite Starten des Servers mit --write.

Datenschutz zuerst

Wir sammeln, speichern oder übertragen niemals Ihre Daten an einen von diesem Projekt betriebenen Server – wir besitzen keine. Details finden Sie in unserer Datenschutzrichtlinie.

• Keine Analysen, Telemetrie oder Tracking jeglicher Art

• Lesezugriffe sind vollständig lokal – null Netzwerkanfragen

• Standardmäßig schreibgeschützt (Schreib-Werkzeuge sind deaktiviert, sofern Sie nicht --write übergeben)

• Im optionalen Schreibmodus gehen Anfragen direkt von Ihrem Rechner an das Firebase/Firestore-Backend von Copilot Money unter Verwendung Ihrer eigenen Anmeldedaten – niemals über einen Drittanbieter-Dienst

• Open Source – überprüfen Sie den Code selbst

Schnellstart

Voraussetzungen

• Node.js 18+ (im Lieferumfang von Claude Desktop enthalten)

• Copilot Money (macOS App Store-Version)

• Claude Desktop, Cursor oder ein beliebiger MCP-kompatibler Client

Installation über Claude Desktop

1. Laden Sie das neueste .mcpb-Bundle von den Releases herunter

2. Doppelklicken Sie auf die .mcpb-Datei, um sie in Claude Desktop zu installieren

3. Starten Sie Claude Desktop neu

4. Beginnen Sie, Fragen zu Ihren Finanzen zu stellen!

Installation über npm

npm install -g copilot-money-mcp

Fügen Sie dies dann zu Ihrer Claude Desktop-Konfiguration hinzu (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "copilot-money": {
      "command": "copilot-money-mcp"
    }
  }
}

Installation für Cursor

1. Installieren Sie das Paket global:

   npm install -g copilot-money-mcp

2. Öffnen Sie die Cursor-Einstellungen (Cmd + ,) > Features > MCP Servers

3. Fügen Sie die Serverkonfiguration hinzu:

   {
     "mcpServers": {
       "copilot-money": {
         "command": "copilot-money-mcp"
       }
     }
   }

Was Sie tun können

Ausgabenanalyse

"Wie viel habe ich letzten Monat für Restaurantbesuche ausgegeben?"

"Zeige mir alle meine Amazon-Einkäufe der letzten 30 Tage"

"Was sind meine Top-5-Ausgabenkategorien in diesem Jahr?"

Verwendet get_transactions, get_categories mit Datumsbereichen, Textsuche und Kategoriefiltern.

Kontoübersicht

"Wie hoch ist mein Nettovermögen über alle Konten hinweg?"

"Zeige mir meinen Girokontostand der letzten 6 Monate, monatlich"

"Welche Bankverbindungen benötigen Aufmerksamkeit?"

Verwendet get_accounts, get_balance_history, get_connection_status.

Anlageportfolio

"Was sind meine aktuellen Bestände und Gesamtrenditen?"

"Zeige mir die AAPL-Preishistorie für das letzte Jahr"

"Wie hoch ist meine zeitgewichtete Rendite in diesem Quartal?"

Verwendet get_holdings, get_investment_prices, get_securities, get_investment_performance, get_twr_returns.

Budgets & Ziele

"Bin ich diesen Monat im Rahmen meiner Budgets?"

"Wie entwickelt sich mein Notgroschen?"

"Zeige mir meine Zielhistorie der letzten 6 Monate"

Verwendet get_budgets, get_goals, get_goal_history.

Abonnements & Wiederkehrendes

"Für welche Abonnements zahle ich?"

"Wie viel gebe ich pro Monat für wiederkehrende Zahlungen aus?"

Verwendet get_recurring_transactions.

Organisieren Ihrer Finanzen (Schreibmodus)

"Kategorisiere alle meine Uber-Transaktionen als Transport"

"Markiere meine Urlaubsausgaben mit #urlaub"

"Erstelle ein monatliches Restaurant-Budget von 500 €"

"Richte Netflix als monatliche wiederkehrende Zahlung ein"

Verwendet Schreib-Werkzeuge wie update_transaction, create_budget, update_recurring und mehr. Erfordert das --write-Flag.

Verfügbare Werkzeuge

Lese-Werkzeuge (17)

Schreib-Werkzeuge (18) — erfordert --write-Flag

Schreibmodus

Standardmäßig startet der Server im schreibgeschützten Modus. Um Schreib-Werkzeuge zu aktivieren, starten Sie den Server mit dem --write-Flag:

{
  "mcpServers": {
    "copilot-money": {
      "command": "copilot-money-mcp",
      "args": ["--write"]
    }
  }
}

Schreib-Werkzeuge ändern Ihre Copilot Money-Daten, indem sie authentifizierte Anfragen direkt an das Firebase/Firestore-Backend von Copilot Money senden – dasselbe Backend, das die Copilot Money-App verwendet –, sodass Ihre Änderungen sofort in Ihrem Konto widergespiegelt werden. Schreibvorgänge authentifizieren sich mithilfe eines Firebase-Refresh-Tokens, das aus Ihrer lokalen Copilot Money-Sitzung extrahiert wurde; Ihre Anmeldedaten verlassen niemals Ihren Rechner, außer in der authentifizierten Anfrage an die Firebase/Firestore-Endpunkte von Google. Es sind keine Drittanbieter-Dienste beteiligt. Vollständige Details finden Sie in PRIVACY.md.

Konfiguration

Cache TTL

Der Server speichert Daten für 5 Minuten im Arbeitsspeicher. Konfiguration über Umgebungsvariable:

# Set cache TTL to 10 minutes
COPILOT_CACHE_TTL_MINUTES=10 copilot-money-mcp

# Disable caching (always reload from disk)
COPILOT_CACHE_TTL_MINUTES=0 copilot-money-mcp

Sie können auch manuell über das Werkzeug refresh_database aktualisieren.

Decode-Timeout

Für große Datenbanken (500 MB+) erhöhen Sie das Decode-Timeout (Standard: 90 Sekunden):

# Via environment variable
DECODE_TIMEOUT_MS=600000 copilot-money-mcp

# Via CLI flag
copilot-money-mcp --timeout 600000

Für Datenbanken über 1 GB erhöhen Sie zusätzlich den Node.js-Speicher:

{
  "mcpServers": {
    "copilot-money": {
      "command": "node",
      "args": [
        "--max-old-space-size=4096",
        "/path/to/copilot-money-mcp/dist/cli.js",
        "--timeout", "600000"
      ]
    }
  }
}

Unterstützte Zeiträume

Der Parameter period unterstützt diese Kürzel:

this_month last_month last_7_days last_30_days last_90_days ytd this_year last_year

Bekannte Einschränkungen

Abhängigkeit vom lokalen Cache

Dieser Server liest aus dem lokalen Firestore-Cache von Copilot Money, nicht aus der Cloud. Die Offline-Persistenz von Firestore speichert jedes Dokument, das die App jemals abgerufen hat, sodass die lokale Datenbank im Allgemeinen alle Transaktionen, Konten, Budgets, Ziele und andere Daten enthält, die Sie in der App angesehen haben. Die Standardgröße des Firestore-Caches beträgt 100 MB (ausreichend für zehntausende Transaktionen), und ältere Dokumente werden nur durch LRU-Garbage-Collection entfernt, wenn dieses Limit überschritten wird.

Um die zwischengespeicherten Daten zu maximieren: Öffnen Sie die Copilot Money-App und durchsuchen Sie Ihre Daten (Transaktionsverlauf, Konten, Budgets), um sicherzustellen, dass sie abgerufen und lokal zwischengespeichert wurden.

Fehlerbehebung

Datenbank nicht gefunden

Wenn Sie "Database not available" sehen:

1. Stellen Sie sicher, dass Copilot Money installiert ist und Daten synchronisiert hat

2. Überprüfen Sie den Speicherort der Datenbank: ~/Library/Containers/com.copilot.production/Data/Library/Application Support/firestore/__FIRAPP_DEFAULT/copilot-production-22904/main

3. Überprüfen Sie, ob .ldb-Dateien im Verzeichnis vorhanden sind

4. Geben Sie einen benutzerdefinierten Pfad an: copilot-money-mcp --db-path /pfad/zur/datenbank

Decode-Worker-Timeout

Wenn Sie "Decode worker timed out" sehen:

1. Erhöhen Sie das Timeout: copilot-money-mcp --timeout 300000 (5 Minuten)

2. Für Datenbanken ab 1 GB erhöhen Sie zusätzlich den Node.js-Speicher: node --max-old-space-size=4096 dist/cli.js --timeout 300000

Keine Transaktionen gefunden

• Öffnen Sie die Copilot Money-App und warten Sie auf die Synchronisierung

• Die Datenbankstruktur könnte sich geändert haben – öffnen Sie ein Issue

Mitwirken

Siehe CONTRIBUTING.md für die Entwicklungseinrichtung, Architektur und wie man neue Werkzeuge hinzufügt.

Lizenz

MIT-Lizenz – Siehe LICENSE für Details.

Danksagungen

• Erstellt mit dem MCP SDK von Anthropic

• Datenvalidierung mit Zod

• Entwickelt mit Bun