PocketSmith Read-only

offiziell

Schreibgeschü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:

ModusBeschreibungVerbindung herstellen
VollzugriffAlle 66 Tools – lesen, erstellen, aktualisieren und löschenMit einem Klick über das Claude- oder ChatGPT-Verzeichnis
Nur-Lese-Zugriff40 schreibgeschützte Tools – ansehen und analysieren, keine ÄnderungenManuelle 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:

  1. Öffne PocketSmith Complete Access im Claude-Verzeichnis
  2. Klicke auf Connect
  3. 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:

  1. Öffne auf claude.ai oder in Claude Desktop Settings > Connectors
  2. Klicke auf Add custom connector
  3. Gib einen Namen ein (z. B. „PocketSmith Read-only“) und die URL https://mcp-readonly.pocketsmith.com/mcp
  4. 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:

  1. Öffne PocketSmith im ChatGPT-App-Verzeichnis auf chatgpt.com
  2. Klicke auf Connect
  3. 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:

  1. Öffne Settings > Apps & Connectors und aktiviere den Developer mode (unter Advanced settings)
  2. Klicke auf Create, um einen benutzerdefinierten Connector hinzuzufügen
  3. Gib einen Namen ein (z. B. „PocketSmith Read-only“) und die URL https://mcp-readonly.pocketsmith.com/mcp
  4. 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

ModusURL
Vollzugriffhttps://mcp.pocketsmith.com/mcp
Nur-Lese-Zugriffhttps://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:

ToolFunktion
financial_health_snapshotNettovermögen, Ausgabentempo, Budgetstatus, Aufgaben
month_end_reviewVollständige Übersicht für einen Zeitraum mit Einnahmen/Ausgaben, Sparquote, Budgetabweichungen und wichtigsten Zahlungsempfängern
spending_comparisonDirekter Vergleich zweier Zeiträume nach Kategorie und Zahlungsempfänger
find_recurring_expensesAbonnements und wiederkehrende Rechnungen mit jährlichen Gesamtkosten erkennen
cash_flow_forecastPrognosen zukünftiger Kontostände mit Warnungen bei kritischen Werten
net_worth_forecastEntwicklung des Nettovermögens mit historischem Trend, Prognose und Meilensteinprognosen
forecast_accuracyTatsächliche und prognostizierte Kontostände vergleichen, um die Zuverlässigkeit des Budgets zu bewerten

Budgetierung

ToolFunktion
get_budgetBudgetanalyse nach Kategorie für den Prognosezeitraum
get_budget_summaryTatsächliche Ausgaben/Einnahmen im Vergleich zum Budget für einen Datumsbereich
get_trend_analysisAusgabentrends nach Kategorie im Zeitverlauf
delete_forecast_cacheBudget nach umfangreichen Änderungen neu berechnen

Transaktionen

ToolFunktion
list_transactionsTransaktionen nach Datum, Kategorie, Stichwort und Status suchen und filtern
get_transactionAlle Details zu einer einzelnen Transaktion abrufen
create_transactionEine neue Transaktion hinzufügen
update_transactionEine Transaktion bearbeiten (Zahlungsempfänger, Kategorie, Labels, Notizen, Aufteilungen)
delete_transactionEine Transaktion entfernen

Konten und Finanzinstitute

ToolFunktion
list_accountsAlle Konten nach Benutzer oder Finanzinstitut auflisten
get_accountKontodetails einschließlich Kontostand und Unterkonten abrufen
create_account / update_account / delete_accountKonten verwalten
update_account_display_orderKonten neu anordnen
list_institutions / get_institutionFinanzinstitute anzeigen
create_institution / update_institution / delete_institutionFinanzinstitute verwalten
list_transaction_accounts / get_transaction_account / update_transaction_accountTransaktionskonten anzeigen und aktualisieren

Kategorien und Regeln

ToolBeschreibung
list_categories / get_categoryHierarchie deiner Kategorien anzeigen
create_category / update_category / delete_categoryKategorien verwalten
list_category_rules / create_category_ruleRegeln für die automatische Kategorisierung anzeigen und erstellen

Budgetereignisse

ToolBeschreibung
list_events / get_eventBudgetprognoseereignisse anzeigen
create_event / update_event / delete_eventWiederkehrende und einmalige Budgetereignisse verwalten

Anhänge

ToolBeschreibung
list_attachments / get_attachmentBeleg- und Dokumentanhänge anzeigen
create_attachment / update_attachment / delete_attachmentAnhänge verwalten
assign_transaction_attachment / unassign_transaction_attachmentAnhänge mit Transaktionen verknüpfen oder Verknüpfungen aufheben

Datenfeeds

ToolBeschreibung
get_data_feeds_connection_statusSynchronisierungsstatus und Anbieterdetails des Bankfeeds prüfen
refresh_data_feeds_connectionSynchronisierung 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.

ToolBeschreibung
navigate_to_transactionsTransaktionssuche, gefiltert nach Konto, Kategorie, Stichwort oder Datum
navigate_to_budgetZur Budgetseite navigieren; Datumseinstellungen und weitere Optionen lassen sich über den Link steuern
navigate_to_trendsTrendbericht zu den Ausgaben oder Einnahmen einer Kategorie im Zeitverlauf; alle Optionen sind über den Link verfügbar
navigate_to_income_expenseEinnahmen- und Ausgabenbericht (Gewinn- und Verlustrechnung) mit Filtern, Datumsbereichen und weiteren Optionen über den Link
navigate_to_cashflowsCashflow-Aufstellung (Monatstabelle)
navigate_to_net_worthZur Seite „Nettovermögen“ navigieren; alle Filter und weiteren Optionen sind über den Link verfügbar
navigate_to_calendarKalender mit geplanten und prognostizierten Budgetereignissen und Salden sowie Datumsbereichen, die über den Link verfügbar sind
navigate_to_account_summaryKontoübersicht für ein bestimmtes Konto und einen bestimmten Monat

Sonstiges

ToolBeschreibung
get_current_user / update_userBenutzerprofil und Einstellungen anzeigen und aktualisieren
list_labelsAlle Transaktionslabels anzeigen
list_saved_searchesGespeicherte Transaktionssuchfilter anzeigen
list_currencies / get_currencyWährungsreferenzdaten
list_time_zonesZeitzonenreferenzdaten

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

Support