Firefly III MCP-Server

Ein MCP-Server (Model Context Protocol), der Claude vollen Zugriff auf Ihre Firefly III-Instanz für persönliche Finanzen gewährt. Sprechen Sie mit Claude in natürlicher Sprache, um Ausgaben zu erfassen, Kontostände zu prüfen, Budgets zu verwalten und mehr.

Funktionen

• Transaktionen: Erstellen, auflisten, suchen, aktualisieren und löschen von Transaktionen (Abhebungen, Einzahlungen, Überweisungen)

• Konten: Verwalten von Vermögens-, Ausgaben-, Einnahmen-, Verbindlichkeits- und Barkonten

• Kategorien: Organisieren von Transaktionen mit Kategorien

• Budgets: Erstellen und Verwalten von Budgets mit Unterstützung für automatische Budgets

• Tags: Kennzeichnen von Transaktionen mit flexiblen Tags

Voraussetzungen

• Node.js >= 18

• Eine laufende Firefly III-Instanz

• Ein Personal Access Token (PAT) von Ihrer Firefly III-Instanz

Abrufen Ihres PAT

1. Melden Sie sich bei Ihrer Firefly III-Instanz an

2. Gehen Sie zu Optionen → Profil → OAuth

3. Erstellen Sie unter Personal Access Tokens ein neues Token

4. Kopieren Sie das Token – Sie benötigen es für die Konfiguration

Installation

Via npm (empfohlen)

npm install -g firefly-iii-mcp-server

Aus dem Quellcode

git clone https://github.com/przbadu/firefly-iii-mcp-server.git
cd firefly-iii-mcp-server
npm install
npm run build

Konfiguration

Claude Desktop

Bearbeiten Sie Ihre Claude Desktop-Konfigurationsdatei:

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

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

Verwendung der über npm installierten Binärdatei:

{
  "mcpServers": {
    "firefly-iii": {
      "command": "firefly-iii-mcp-server",
      "env": {
        "FIREFLY_III_URL": "https://your-firefly-instance.example.com",
        "FIREFLY_III_PAT": "your-personal-access-token-here"
      }
    }
  }
}

Oder unter Verwendung von npx (keine globale Installation erforderlich):

{
  "mcpServers": {
    "firefly-iii": {
      "command": "npx",
      "args": ["-y", "firefly-iii-mcp-server"],
      "env": {
        "FIREFLY_III_URL": "https://your-firefly-instance.example.com",
        "FIREFLY_III_PAT": "your-personal-access-token-here"
      }
    }
  }
}

Claude Code CLI

claude mcp add firefly-iii \
  -e FIREFLY_III_URL=https://your-firefly-instance.example.com \
  -e FIREFLY_III_PAT=your-personal-access-token-here \
  -- npx -y firefly-iii-mcp-server

Oder fügen Sie es Ihrer .claude/settings.json hinzu:

{
  "mcpServers": {
    "firefly-iii": {
      "command": "npx",
      "args": ["-y", "firefly-iii-mcp-server"],
      "env": {
        "FIREFLY_III_URL": "https://your-firefly-instance.example.com",
        "FIREFLY_III_PAT": "your-personal-access-token-here"
      }
    }
  }
}

Anwendungsbeispiele

Sobald die Konfiguration abgeschlossen ist, können Sie einfach natürlich mit Claude sprechen:

Transaktionen erfassen

"Ich habe heute bei Trader Joe's 45,50 $ für Lebensmittel ausgegeben"

"Erfasse eine Gehaltseinzahlung von 2.500 $ von meinem Arbeitgeber auf mein Girokonto"

"Überweise 500 $ vom Girokonto auf das Sparkonto"

Abfragen

"Zeige mir alle meine Transaktionen der letzten Woche"

"Wie viel habe ich diesen Monat für Restaurants ausgegeben?"

"Wie hoch ist der Kontostand meines Girokontos?"

Finanzen verwalten

"Erstelle ein monatliches Lebensmittelbudget von 600 $"

"Liste alle meine Ausgabenkategorien auf"

"Markiere meine letzten 3 Restauranttransaktionen als 'Geschäftsessen'"

Verfügbare Tools

Entwicklung

# Watch mode with auto-reload
npm run dev

# Build for production
npm run build

# Run the built server
npm start

Lizenz

MIT