Was macht expense-bookkeeper?
Persönlicher Ausgaben-Tracker – Claude Skill + eigenständiges Python-CLI. Kartenbenachrichtigungen → Google-Tabellenbuch.
Beschreibung
Dieses Projekt automatisiert die Erfassung von Ausgaben aus Kartenbenachrichtigungen (z. B. SMS oder E-Mail) und speichert sie in einer Google-Tabelle. Es funktioniert sowohl als Claude Skill als auch als eigenständiges Python-CLI-Tool.
Funktionen
- Automatische Erfassung: Interpretiert Kartenbenachrichtigungen und extrahiert Betrag, Datum und Händler.
- Google-Sheet-Integration: Schreibt Ausgaben direkt in ein Google Sheet.
- Kategorisierung: Ordnet Ausgaben automatisch Kategorien zu (optional).
- Multi-Plattform: Funktioniert mit Claude Code, Cursor und Codex.
Voraussetzungen
- Python 3.8 oder höher
- Google-Konto mit Zugriff auf Google Sheets
- Ein Google Cloud-Projekt mit aktivierter Sheets-API
Installation
-
Repository klonen:
git clone https://github.com/m83iyer/expense-bookkeeper.git cd expense-bookkeeper -
Abhängigkeiten installieren:
pip install -r requirements.txt -
Google Sheets API-Anmeldeinformationen einrichten:
- Erstellen Sie ein Service-Konto in der Google Cloud Console.
- Laden Sie die JSON-Datei mit den Anmeldeinformationen herunter.
- Teilen Sie die Ziel-Google-Tabelle mit der E-Mail-Adresse des Service-Kontos.
Verwendung
Als Claude Skill
Fügen Sie das Skill-Verzeichnis zu Ihrem Claude-Projekt hinzu. Der Skill erkennt eingehende Benachrichtigungen und verarbeitet sie automatisch.
Als eigenständiges CLI
python expense_bookkeeper.py --input benachrichtigung.txt
oder mit Pipe:
cat benachrichtigung.txt | python expense_bookkeeper.py
Konfiguration
Konfigurieren Sie die Umgebungsvariablen:
GOOGLE_SHEETS_CREDENTIALS: Pfad zur JSON-Datei mit den Google-Anmeldeinformationen.GOOGLE_SHEET_ID: ID der Google-Tabelle.CATEGORIES_FILE: (Optional) Pfad zu einer JSON-Datei mit Kategoriezuordnungen.
Beispiel
Beispiel für eine Benachrichtigung:
Kartenzahlung: 12.50€ bei CAFE CENTRAL am 15.01.2024
Ausgabe in der Google-Tabelle:
| Datum | Betrag | Händler | Kategorie |
|---|---|---|---|
| 2024-01-15 | 12.50 | CAFE CENTRAL | Essen |
Lizenz
MIT