Skip to main content
Glama
ajayanta

expense-tracker

by ajayanta

Expense Tracker MCP Server

Ein leichtgewichtiger lokaler MCP-Server (Model Context Protocol), mit dem du persönliche Ausgaben direkt über Claude erfassen, auflisten, zusammenfassen und entfernen kannst – ohne App, ohne manuelle Tabellenpflege, einfach durch natürliche Konversation.

Erstellt mit FastMCP und unterstützt durch eine lokale SQLite-Datenbank.

Warum

Die meisten Ausgaben-Tracking-Apps sind umständlich: zu viele Klicks, starre Kategorien oder Abo-Bezahlschranken, nur um einen Kaffee zu erfassen. Dieser Server macht Claude zu deinem Ausgaben-Tracker – du sagst einfach, was du ausgegeben hast, und es wird gespeichert. Frage jederzeit nach einer Zusammenfassung und erhalte sofort eine Aufschlüsselung nach Kategorie.

Related MCP server: Expense Tracker MCP Server

Funktionen

  • Ausgaben hinzufügen mit Datum, Kategorie, Betrag, Unterkategorie und Notizen

  • Ausgaben auflisten innerhalb eines Datumsbereichs

  • Ausgaben zusammenfassen nach Kategorie (optional gefiltert auf eine Kategorie)

  • Ausgaben entfernen per ID

  • Daten werden lokal in einer einzigen SQLite-Datei gespeichert – vollständig privat, keine Cloud-Synchronisierung

Voraussetzungen

Abhängigkeiten installieren:

pip install fastmcp

Einrichtung

  1. Speichere das Server-Skript (z. B. expense_server.py) an einem dauerhaften Ort auf deinem Rechner.

  2. Beim ersten Start wird automatisch expenses.db im selben Verzeichnis erstellt – keine manuelle Datenbankeinrichtung erforderlich.

  3. Füge es zu deiner Claude-Desktop-Konfigurationsdatei hinzu:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

    • Windows: %APPDATA%\Claude\claude_desktop_config.json

    {
      "mcpServers": {
        "expense-tracker": {
          "command": "python",
          "args": ["/full/absolute/path/to/expense_server.py"]
        }
      }
    }

    Verwende den absoluten Pfad zum Skript. Wenn du eine virtuelle Umgebung verwendest, weise command auf das Python-Binary dieser Umgebung anstelle des System-python.

  4. Starte Claude Desktop neu. Die vier unten aufgeführten Tools sollten als verfügbar erscheinen.

Werkzeuge

Werkzeug

Beschreibung

Parameter

add_expense

Fügt eine neue Ausgabe hinzu

date, category, amount, subcategory (optional), note (optional)

list_expenses

Listet Ausgaben in einem Datumsbereich auf

start_date, end_date

summarize_expenses

Summiert Ausgaben nach Kategorie in einem Datumsbereich

start_date, end_date, category (optional)

remove_expense

Löscht eine Ausgabe per ID

expense_id

Daten sollten im Format YYYY-MM-DD angegeben werden.

Beispielverwendung

Sprich einfach natürlich mit Claude, sobald der Server verbunden ist:

  • „Erfasse 450 für Lebensmittel heute, Unterkategorie Gemüse“

  • „Ich habe gestern 1200 für Miete ausgegeben, Notiz: Augustmiete“

  • „Zeig mir alles, was ich diesen Monat ausgegeben habe“

  • „Wie sieht meine Aufschlüsselung nach Kategorie für August 2026 aus?“

  • „Wie viel habe ich zwischen dem 1. und 15. August für Essen ausgegeben?“

  • „Lösche Ausgabe #12, ich habe das doppelt eingegeben“

Datenspeicherung

Alle Daten befinden sich in expenses.db, einer SQLite-Datei, die neben dem Skript erstellt wird. Es wird nichts an andere Orte gesendet – das ist vollständig lokal und privat.

Schema:

expenses
├── id            INTEGER PRIMARY KEY AUTOINCREMENT
├── date          TEXT NOT NULL
├── category      TEXT NOT NULL
├── amount        REAL NOT NULL
├── subcategory   TEXT DEFAULT ''
└── note          TEXT DEFAULT ''

Sichern deiner Daten

Da alles in einer Datei liegt, sichere sie regelmäßig:

cp expenses.db "expenses_backup_$(date +%Y%m%d).db"

Erwäge, dies mit einem wöchentlichen Cron-Job (macOS/Linux) oder dem Taskplaner (Windows) zu automatisieren.

Hinweise & Tipps

  • Kategorienamen sind nicht eingeschränkt, also versuche, Groß-/Kleinschreibung und Schreibweise konsistent zu halten (z. B. immer „Groceries“, nicht eine Mischung aus „groceries“ / „Grocery“), um die Zusammenfassungen sauber zu halten.

  • Bitte Claude, deine vorhandenen Kategorien aufzulisten, bevor du eine neue hinzufügst, wenn du Duplikate vermeiden möchtest.

  • Dieser Server hat keine Authentifizierung und keine Netzwerkfreigabe – er läuft nur lokal über stdio, weshalb er ohne zusätzliche Sicherheitskonfiguration sicher verwendet werden kann.

Lizenz

Persönliche Nutzung – passe es frei an deinen eigenen Workflow an.

Related MCP Connectors

Related MCP Servers

  • F
    license
    C
    quality
    D
    maintenance
    Enables personal expense management with SQLite storage, allowing users to add, update, delete, list, and summarize expenses by category through natural language interactions.
    5
    -
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables management of expenses via SQLite database, including adding, listing, updating, deleting, filtering, and summing expenses through natural language.
    -
  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables natural language management of personal expenses, including adding, listing, and summarizing expenses with local SQLite storage.
    -