PocketSmith Read-only
offiziellSchreibgeschützt: Transaktionen, Budgets, Prognosen und Einblicke aus dem persönlichen Finanztool PocketSmith.
Was kann man mit PocketSmith Read Only MCP machen?
- Finanzielle Bestandsaufnahme — Bitte um einen Überblick über das Nettovermögen, die Ausgabengeschwindigkeit im Vergleich zum Budget und den Status der Budgets nach Kategorie.
- Ausgabenvergleiche — Ausgaben zwischen zwei Zeiträumen nach Kategorie und Zahlungsempfänger vergleichen, um zu sehen, was sich geändert hat.
- Erkennung wiederkehrender Ausgaben — Abonnements und wiederkehrende Rechnungen mit Häufigkeit und jährlichen Gesamtkosten finden.
- Prognosen zu Cashflow und Nettovermögen — Kontostände und Nettovermögen mithilfe der Prognose-Engine von PocketSmith für die Zukunft berechnen.
- Transaktionssuche — Transaktionen nach Datum, Kategorie, Stichwort oder Status filtern und suchen.
- Direktlinks — Einen Link zur genau passenden PocketSmith-Seite, zum Bericht oder zur besprochenen gefilterten Suche erhalten.
Gehosteter MCP-Server
npx add-mcp 'https://mcp-readonly.pocketsmith.com/mcp'Installiert in Claude Code, Codex, Cursor und mehr
Dokumentation
MCP-Server
Verbinde dein PocketSmith-Konto mit jedem KI-Assistenten, der das Model Context Protocol unterstützt.
Wenn du deinen KI-Assistenten über das Model Context Protocol (MCP) mit PocketSmith verbindest, erhält er direkten Zugriff auf deine Finanzdaten, Budgets und Prognosen. Er kann dir Einblicke und Informationen liefern und verschiedene Aktionen für dich ausführen.
Was es kann
Der PocketSmith-MCP-Server ermöglicht KI-Assistenten, deine PocketSmith-Daten in deinem Auftrag zu lesen und zu verwalten. Statt zwischen deinem KI-Assistenten und PocketSmith zu wechseln, kannst du Fragen stellen und Aktionen in natürlicher Sprache ausführen:
- Deine Ausgaben, Budgets und dein Nettovermögen überprüfen
- Transaktionen suchen und kategorisieren
- Budgetereignisse erstellen und aktualisieren
- Trends analysieren und Ausgaben über verschiedene Zeiträume vergleichen
- Den Synchronisierungsstatus des Bankdaten-Feeds prüfen und Aktualisierungen auslösen
- Direktlinks zur passenden PocketSmith-Seite oder zum passenden Bericht erhalten
Es stehen zwei Zugriffsmodi zur Verfügung:
| Modus | Beschreibung | Verbindung herstellen |
|---|---|---|
| Vollzugriff | Alle 66 Tools – lesen, erstellen, aktualisieren und löschen | Mit einem Klick über das Claude- oder ChatGPT-Verzeichnis |
| Nur-Lese-Zugriff | 40 schreibgeschützte Tools – ansehen und analysieren, keine Änderungen | Manuelle Einrichtung als benutzerdefinierter Connector (ein paar zusätzliche Schritte) |
Die meisten sollten den Vollzugriff wählen. Zum Löschen ist immer zuerst deine ausdrückliche Zustimmung erforderlich. Du kannst den Assistenten außerdem bitten, vor jeder anderen Änderung bei dir nachzufragen. Wähle den Nur-Lese-Zugriff, wenn du sicherstellen möchtest, dass der Assistent deine Daten niemals ändern kann.
Verbindung herstellen
Der Vollzugriff ist als gelistete App in den Verzeichnissen von Claude und ChatGPT verfügbar, sodass die Verbindung mit einem einzigen Klick hergestellt werden kann. Der Nur-Lese-Zugriff ist noch in keinem der beiden Verzeichnisse gelistet und muss daher manuell als benutzerdefinierter Connector eingerichtet werden. Verwende dazu die URL unter Andere MCP-Clients.
Claude (claude.ai, Claude Desktop und mobile Apps)
Vollzugriff:
- Öffne PocketSmith Complete Access im Claude-Verzeichnis
- Klicke auf Connect
- Du wirst zu PocketSmith weitergeleitet, um den Zugriff zu autorisieren
Connectoren sind mit deinem Claude-Konto verknüpft. Sobald du die Verbindung auf claude.ai hergestellt hast, ist PocketSmith auch in Claude Desktop und den mobilen Claude-Apps verfügbar.
Nur-Lese-Zugriff:
- Öffne auf claude.ai oder in Claude Desktop Settings > Connectors
- Klicke auf Add custom connector
- Gib einen Namen ein (z. B. „PocketSmith Read-only“) und die URL
https://mcp-readonly.pocketsmith.com/mcp - Klicke neben dem neuen Connector auf Connect und autorisiere den Zugriff bei PocketSmith
Claude Code
# Full access
claude mcp add pocketsmith --transport http https://mcp.pocketsmith.com/mcp
# Read-only
claude mcp add pocketsmith-readonly --transport http https://mcp-readonly.pocketsmith.com/mcp
Claude Code fordert dich bei der ersten Verwendung auf, dich über OAuth zu autorisieren.
ChatGPT (chatgpt.com und Desktop-App)
Vollzugriff:
- Öffne PocketSmith im ChatGPT-App-Verzeichnis auf chatgpt.com
- Klicke auf Connect
- Du wirst zu PocketSmith weitergeleitet, um den Zugriff zu autorisieren
Apps sind mit deinem ChatGPT-Konto verknüpft. Sobald du die Verbindung auf chatgpt.com hergestellt hast, ist PocketSmith auch in der ChatGPT-Desktop-App verfügbar. Falls die App nicht angezeigt wird, starte die Desktop-App neu.
Nur-Lese-Zugriff:
Der Nur-Lese-Zugriff muss auf chatgpt.com eingerichtet werden, nicht in der Desktop-App:
- Öffne Settings > Apps & Connectors und aktiviere den Developer mode (unter Advanced settings)
- Klicke auf Create, um einen benutzerdefinierten Connector hinzuzufügen
- Gib einen Namen ein (z. B. „PocketSmith Read-only“) und die URL
https://mcp-readonly.pocketsmith.com/mcp - Klicke auf Connect – du wirst zu PocketSmith weitergeleitet, um den Zugriff zu autorisieren
Verwende nicht die Option Settings > Plugins > Add MCP server in der Desktop-App – dort hinzugefügte Server sind nur in Codex verfügbar, nicht in ChatGPT.
Business-/Enterprise-/Edu-Arbeitsbereiche: Ein Arbeitsbereichsadministrator muss zuerst die App aktivieren oder den Connector über Workspace settings hinzufügen. Anschließend verbindet sich jeder Benutzer einzeln mit seinem eigenen PocketSmith-Konto und autorisiert den Zugriff.
Codex
Vollzugriff: Wenn du PocketSmith bereits über das ChatGPT-App-Verzeichnis verbunden hast, ist es ab deinem nächsten Chat automatisch in Codex verfügbar. Andernfalls füge es über die Befehlszeile hinzu:
codex mcp add pocketsmith --transport http https://mcp.pocketsmith.com/mcp
Nur-Lese-Zugriff:
codex mcp add pocketsmith-readonly --transport http https://mcp-readonly.pocketsmith.com/mcp
Codex fordert dich bei der ersten Verwendung auf, dich über OAuth zu autorisieren.
Andere MCP-Clients
| Modus | URL |
|---|---|
| Vollzugriff | https://mcp.pocketsmith.com/mcp |
| Nur-Lese-Zugriff | https://mcp-readonly.pocketsmith.com/mcp |
Jeder MCP-Client, der HTTP-Transport und OAuth unterstützt, kann sich über diese URLs verbinden. Der Server unterstützt OAuth 2.0 mit PKCE und veröffentlicht Erkennungsmetadaten unter /.well-known/oauth-authorization-server und /.well-known/oauth-protected-resource.
Authentifizierung
Die Authentifizierung erfolgt automatisch über OAuth. Wenn du dich zum ersten Mal verbindest, wirst du zu PocketSmith weitergeleitet, um dich anzumelden und den Zugriff zu gewähren. Der KI-Assistent erhält ein Token, das auf den von dir gewählten Zugriffsmodus (Vollzugriff oder Nur-Lese-Zugriff) beschränkt ist, und sieht niemals dein PocketSmith-Passwort.
Tokens werden verschlüsselt und zustandslos verarbeitet – auf dem MCP-Server werden keine Daten gespeichert. Du kannst den Zugriff jederzeit auf der Seite Autorisierte Anwendungen in PocketSmith widerrufen.
Anwendungsbeispiele
„Wie läuft es diesen Monat bei mir?“
Bitte um einen Finanzcheck, um eine kompakte Übersicht zu erhalten:
Du: Wie sieht es diesen Monat finanziell bei mir aus? Bin ich mit meinem Budget auf Kurs?
Verwendet das Tool financial_health_snapshot, um dein Nettovermögen, dein Ausgabentempo im laufenden Monat im Vergleich zum Budget, den Status der Budgets nach Kategorie und mögliche Aufgaben wie nicht kategorisierte Transaktionen anzuzeigen.
„Welche Abonnements bezahle ich?“
Finde wiederkehrende Abbuchungen, die du vielleicht vergessen hast:
Du: Kannst du alle meine wiederkehrenden Ausgaben und Abonnements finden? Ich möchte sehen, was ich jeden Monat bezahle und wie hoch die jährlichen Gesamtkosten sind.
Verwendet das Tool find_recurring_expenses, um deinen Transaktionsverlauf zu durchsuchen, regelmäßige Abbuchungen nach Zahlungsempfänger zu erkennen, ihre Häufigkeit zu bestimmen und die jährlichen Gesamtkosten zu berechnen.
„Vergleiche meine Ausgaben mit dem letzten Monat“
Sieh dir an, wofür du unterschiedlich viel ausgegeben hast:
Du: Vergleiche meine Ausgaben in diesem Monat mit denen des letzten Monats. Welche Kategorien sind gestiegen oder gesunken?
Verwendet das Tool spending_comparison, um beide Zeiträume nach Kategorie und Zahlungsempfänger aufzuschlüsseln und Änderungen sowie neue oder weggefallene Zahlungsempfänger hervorzuheben.
„Überprüfe meine Finanzen im März“
Erhalte einen umfassenden Monatsabschluss:
Du: Erstelle eine vollständige Übersicht für März 2025 – Einnahmen, Ausgaben, Sparquote und wie ich im Vergleich zu meinem Budget abgeschnitten habe.
Verwendet das Tool month_end_review, um einen detaillierten Bericht mit einer Einnahmen-/Ausgabenübersicht, der Sparquote, Budgetabweichungen nach Kategorie, den wichtigsten Zahlungsempfängern, bemerkenswerten Transaktionen und einer Momentaufnahme des Nettovermögens zu erstellen.
„Kategorisiere meine letzten Transaktionen“
Räume nicht kategorisierte Transaktionen auf:
Du: Ich habe aus der letzten Woche eine ganze Reihe nicht kategorisierter Transaktionen. Kannst du sie dir ansehen und für mich kategorisieren?
Verwendet list_transactions, um aktuelle nicht kategorisierte Transaktionen zu finden, anschließend list_categories, um deine Kategorienstruktur abzurufen, und update_transaction, um anhand der Namen der Zahlungsempfänger passende Kategorien zuzuweisen. (Erfordert den Vollzugriff.)
„Wie hoch ist mein Sparkontostand in 6 Monaten?“
Lass deine Kontostände für die Zukunft prognostizieren:
Du: Wie wird sich mein Sparkontostand in den nächsten 6 Monaten entwickeln, basierend auf meinem Budget?
Verwendet cash_flow_forecast, um mithilfe der Prognosefunktion von PocketSmith zukünftige Kontostände zu berechnen. Dabei wird angezeigt, wie sich die einzelnen Konten entwickeln und ob ein Kontostand möglicherweise unter einen sicheren Schwellenwert fällt.
„Bring mich dorthin“
Erhalte einen direkten Link zur passenden Seite oder zum passenden Bericht in der PocketSmith-Webanwendung:
Du: Wie haben sich meine Ausgaben für Lebensmittel im letzten Jahr verändert? Gib mir einen Link, damit ich mir das selbst genauer ansehen kann.
Verwendet get_trend_analysis, um den Trend zusammenzufassen, und anschließend navigate_to_trends, um einen Direktlink zum Trendbericht zu erstellen – vorgefiltert nach deiner Kategorie „Lebensmittel“ und dem Datumsbereich –, damit du die Daten in PocketSmith weiter erkunden kannst. Alle Navigationstools funktionieren auf diese Weise: Der Assistent antwortet und stellt dir anschließend einen Link zur genauen Seite, zum Bericht oder zur Transaktionssuche bereit, auf die er sich bezogen hat.
Verfügbare Tools
Einblicke (Tools für kombinierte Analysen)
Diese Tools kombinieren mehrere API-Aufrufe, um aussagekräftige, sofort nutzbare Analysen zu erstellen:
| Tool | Funktion |
|---|---|
financial_health_snapshot | Nettovermögen, Ausgabentempo, Budgetstatus, Aufgaben |
month_end_review | Vollständige Übersicht für einen Zeitraum mit Einnahmen/Ausgaben, Sparquote, Budgetabweichungen und wichtigsten Zahlungsempfängern |
spending_comparison | Direkter Vergleich zweier Zeiträume nach Kategorie und Zahlungsempfänger |
find_recurring_expenses | Abonnements und wiederkehrende Rechnungen mit jährlichen Gesamtkosten erkennen |
cash_flow_forecast | Prognosen zukünftiger Kontostände mit Warnungen bei kritischen Werten |
net_worth_forecast | Entwicklung des Nettovermögens mit historischem Trend, Prognose und Meilensteinprognosen |
forecast_accuracy | Tatsächliche und prognostizierte Kontostände vergleichen, um die Zuverlässigkeit des Budgets zu bewerten |
Budgetierung
| Tool | Funktion |
|---|---|
get_budget | Budgetanalyse nach Kategorie für den Prognosezeitraum |
get_budget_summary | Tatsächliche Ausgaben/Einnahmen im Vergleich zum Budget für einen Datumsbereich |
get_trend_analysis | Ausgabentrends nach Kategorie im Zeitverlauf |
delete_forecast_cache | Budget nach umfangreichen Änderungen neu berechnen |
Transaktionen
| Tool | Funktion |
|---|---|
list_transactions | Transaktionen nach Datum, Kategorie, Stichwort und Status suchen und filtern |
get_transaction | Alle Details zu einer einzelnen Transaktion abrufen |
create_transaction | Eine neue Transaktion hinzufügen |
update_transaction | Eine Transaktion bearbeiten (Zahlungsempfänger, Kategorie, Labels, Notizen, Aufteilungen) |
delete_transaction | Eine Transaktion entfernen |
Konten und Finanzinstitute
| Tool | Funktion |
|---|---|
list_accounts | Alle Konten nach Benutzer oder Finanzinstitut auflisten |
get_account | Kontodetails einschließlich Kontostand und Unterkonten abrufen |
create_account / update_account / delete_account | Konten verwalten |
update_account_display_order | Konten neu anordnen |
list_institutions / get_institution | Finanzinstitute anzeigen |
create_institution / update_institution / delete_institution | Finanzinstitute verwalten |
list_transaction_accounts / get_transaction_account / update_transaction_account | Transaktionskonten anzeigen und aktualisieren |
Kategorien und Regeln
| Tool | Beschreibung |
|---|---|
list_categories / get_category | Hierarchie deiner Kategorien anzeigen |
create_category / update_category / delete_category | Kategorien verwalten |
list_category_rules / create_category_rule | Regeln für die automatische Kategorisierung anzeigen und erstellen |
Budgetereignisse
| Tool | Beschreibung |
|---|---|
list_events / get_event | Budgetprognoseereignisse anzeigen |
create_event / update_event / delete_event | Wiederkehrende und einmalige Budgetereignisse verwalten |
Anhänge
| Tool | Beschreibung |
|---|---|
list_attachments / get_attachment | Beleg- und Dokumentanhänge anzeigen |
create_attachment / update_attachment / delete_attachment | Anhänge verwalten |
assign_transaction_attachment / unassign_transaction_attachment | Anhänge mit Transaktionen verknüpfen oder Verknüpfungen aufheben |
Datenfeeds
| Tool | Beschreibung |
|---|---|
get_data_feeds_connection_status | Synchronisierungsstatus und Anbieterdetails des Bankfeeds prüfen |
refresh_data_feeds_connection | Synchronisierung für eine oder alle Bankfeed-Verbindungen starten |
Navigation
Diese Tools erstellen Deeplinks, über die der Assistent dich direkt zur passenden PocketSmith-Seite für das Gespräch führen kann – mit vorausgewählten Konten, Kategorien und Datumsangaben sowie allen weiteren erforderlichen Steuerelementen auf der Seite.
| Tool | Beschreibung |
|---|---|
navigate_to_transactions | Transaktionssuche, gefiltert nach Konto, Kategorie, Stichwort oder Datum |
navigate_to_budget | Zur Budgetseite navigieren; Datumseinstellungen und weitere Optionen lassen sich über den Link steuern |
navigate_to_trends | Trendbericht zu den Ausgaben oder Einnahmen einer Kategorie im Zeitverlauf; alle Optionen sind über den Link verfügbar |
navigate_to_income_expense | Einnahmen- und Ausgabenbericht (Gewinn- und Verlustrechnung) mit Filtern, Datumsbereichen und weiteren Optionen über den Link |
navigate_to_cashflows | Cashflow-Aufstellung (Monatstabelle) |
navigate_to_net_worth | Zur Seite „Nettovermögen“ navigieren; alle Filter und weiteren Optionen sind über den Link verfügbar |
navigate_to_calendar | Kalender mit geplanten und prognostizierten Budgetereignissen und Salden sowie Datumsbereichen, die über den Link verfügbar sind |
navigate_to_account_summary | Kontoübersicht für ein bestimmtes Konto und einen bestimmten Monat |
Sonstiges
| Tool | Beschreibung |
|---|---|
get_current_user / update_user | Benutzerprofil und Einstellungen anzeigen und aktualisieren |
list_labels | Alle Transaktionslabels anzeigen |
list_saved_searches | Gespeicherte Transaktionssuchfilter anzeigen |
list_currencies / get_currency | Währungsreferenzdaten |
list_time_zones | Zeitzonenreferenzdaten |
PocketSmith-Datenmodell
Wenn du die Hierarchie von PocketSmith verstehst, kannst du gezieltere Fragen stellen:
Institution (e.g. "Sample Bank")
→ Account (container/group, e.g. "Everyday Credit Card")
→ Transaction Account (where transactions live)
→ Scenario (where budget forecast events live)
- Finanzinstitute stehen für Banken oder Finanzdienstleister
- Konten umfassen ein oder mehrere Transaktionskonten und Szenarien
- Transaktionskonten enthalten die eigentlichen Transaktionsdatensätze
- Szenarien enthalten Budgetereignisse, die die Prognose-Engine von PocketSmith steuern
- Kategorien sind hierarchisch aufgebaut (über- und untergeordnet) und werden von allen Konten gemeinsam genutzt
- Labels sind Tags, die du Transaktionen zur flexiblen Gruppierung hinzufügen kannst
Datenschutz und Sicherheit
- Datenschutzrichtlinie von PocketSmith: https://www.pocketsmith.com/legal/privacy-policy/
- Deine PocketSmith-Zugangsdaten werden niemals an den KI-Assistenten weitergegeben
- OAuth-Tokens werden mit AES-256-GCM verschlüsselt und zustandslos verarbeitet (serverseitig werden keine Daten gespeichert)
- Die gesamte API-Kommunikation ist TLS-verschlüsselt
- Du kannst den Zugriff jederzeit unter autorisierte Anwendungen von PocketSmith widerrufen
Support
- Hilfe und Support: https://learn.pocketsmith.com
- Support kontaktieren: help@pocketsmith.com