@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:

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

Lokale Entwicklung

{
  "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"