npm package: @goalfuel/mcp
Description: GoalFuel MCP Server – Kalorienzähler per KI-Agent steuern
Latest version: 1.0.2

# @goalfuel/mcp

MCP-Server für GoalFuel – steuere dein Kalorientracking per KI-Agent (Claude, GPT, Cursor & Co.).

## Was kann der MCP-Server?

- Lebensmittel suchen und tracken
- Tagesübersicht und Ziele abrufen
- Gewicht, Wasser und Körpermetriken eintragen
- Rezepte verwalten
- Statistiken abrufen (Pro)
- Meilensteine ansehen

## Voraussetzungen

1. **GoalFuel-Account** mit abgeschlossenem Onboarding
2. **Personal Access Token (PAT)** – erstelle eines in der GoalFuel App unter Einstellungen → API-Zugang
3. **Node.js 18+** installiert

## Einrichtung

### Claude Desktop / Claude Code

Füge in deiner MCP-Konfiguration hinzu:

```json
{
  "mcpServers": {
    "goalfuel": {
      "command": "npx",
      "args": ["-y", "@goalfuel/mcp"],
      "env": {
        "GOALFUEL_PAT": "gf_pat_dein_token_hier"
      }
    }
  }
}
```

### Lokale Entwicklung

```json
{
  "mcpServers": {
    "goalfuel": {
      "command": "node",
      "args": ["./goalfuel-mcp/dist/index.js"],
      "env": {
        "GOALFUEL_PAT": "gf_pat_dein_token_hier"
      }
    }
  }
}
```

## Verfügbare Tools

### Produkte
- `search_products` – Lebensmittel suchen
- `search_product_by_barcode` – Produkt per Barcode finden
- `get_product_details` – Produktdetails abrufen

### Food-Tracking
- `track_food` – Lebensmittel tracken
- `update_food_entry` – Eintrag aktualisieren
- `delete_food_entry` – Eintrag löschen
- `delete_meal_group_entries` – Alle Einträge einer Mahlzeit löschen
- `copy_meal` – Mahlzeit kopieren
- `get_food_entry` – Einzelnen Eintrag abrufen
- `get_food_entries` – Alle Einträge eines Tages
- `get_food_entries_by_group` – Einträge einer Mahlzeit
- `get_group_summaries` – Zusammenfassung pro Mahlzeit
- `search_tracked_products` – In eigener Historie suchen
- `get_recently_tracked` – Zuletzt getrackte Produkte
- `get_most_tracked` – Am häufigsten getrackte Produkte
- `get_recent_meals` – Kürzliche Mahlzeiten

### Tagesübersicht & Gewicht
- `get_daily_summary` – Tagesübersicht (Gewicht, Kalorien)
- `get_daily_entries` – Tagesübersichten ab Datum
- `get_last_weight` – Letztes Gewicht
- `log_weight` – Gewicht eintragen
- `clear_weight` – Gewichtseintrag löschen

### Mahlzeiten-Gruppen
- `get_food_groups` – Gruppen auflisten (Frühstück, Mittagessen, …)
- `get_food_group` – Einzelne Gruppe
- `delete_food_group` – Gruppe löschen

### Ziele
- `get_goals` – Kalorien- und Makroziele für ein Datum

### Wasser
- `get_water` – Wasseraufnahme abrufen
- `log_water` – Wassergläser eintragen
- `delete_water` – Wassereintrag löschen

### Körpermetriken
- `get_body_metric_configs` – Verfügbare Metriken
- `toggle_body_metric` – Metrik aktivieren/deaktivieren
- `create_custom_body_metric` – Eigene Metrik erstellen
- `delete_custom_body_metric` – Eigene Metrik löschen
- `get_body_metric_entries` – Einträge abrufen
- `get_body_metric_entries_by_date` – Einträge für ein Datum
- `log_body_metric` – Metrik-Wert eintragen

### Rezepte
- `get_recipes` – Alle Rezepte
- `get_recipe` – Rezeptdetails
- `create_recipe` – Rezept erstellen
- `update_recipe` – Rezept aktualisieren
- `delete_recipe` – Rezept löschen

### Statistiken (Pro)
- `get_macro_stats` – Makronährstoff-Statistiken
- `get_calorie_deficit_stats` – Kaloriendefizit
- `get_meal_stats` – Kalorien pro Mahlzeit

### Meilensteine
- `get_milestone_gallery` – Meilenstein-Galerie
- `get_milestones` – Erreichte Meilensteine

### Sonstiges
- `get_search_history` – Suchverlauf
- `save_search_term` – Suchbegriff speichern
- `list_pats` – Personal Access Tokens auflisten
- `create_pat` – Neues Token erstellen
- `revoke_pat` – Token widerrufen

## Beispiel-Prompts

- "Was habe ich heute schon gegessen?"
- "Tracke 200g Hähnchenbrust zum Mittagessen"
- "Wie viele Kalorien habe ich heute noch übrig?"
- "Suche nach Proteinriegeln"
- "Trage 78,5 kg Gewicht für heute ein"
- "Füge 3 Gläser Wasser für heute hinzu"