Thermomix-MCP

Rezepte aus beliebigen Quellen (Rezept-Websites, YouTube, Instagram, TikTok, KI) in ein Thermomix-Rezept verwandeln — und wahlweise direkt in Cookidoo → „Meine Kreationen" hochladen, inkl. Guided-Cooking-Schritten und Bild, sodass es am TM7 abrufbar ist.

Zwei Betriebsarten:

• MCP-Server (Chat-Flow) — Claude bekommt die Rohdaten und baut das Rezept.

• Webhook (headless) — nimmt eine geteilte URL entgegen und macht die Umwandlung selbst per Anthropic-API. Ideal für einen „aus jeder App teilen"-Flow.

Kein offizielles Vorwerk-/Cookidoo-API. Der Cookidoo-Upload nutzt eine reverse-engineerte Schnittstelle (cookidoo-api

• rohe created-recipes-Endpoints) und ein aktives Cookidoo-Abo. Das kann jederzeit brechen. Der TM7 selbst lässt sich nicht fernsteuern — nur Content-Sync über den Account.

Quellen

Enthält ein Post kein Rezept (z. B. TikTok-Caption „recipe on the blog"), sucht der Deep-Hunt die Original-Rezeptseite per Websuche und transkribiert notfalls die Tonspur.

Related MCP server: Link Scan MCP Server

MCP-Tools & Prompts

Prompts: thermomix_guide (TM-Konvertierungsregeln), cookidoo_guide (Modus-Zuordnung).

Setup

uv sync                         # Kern
uv sync --extra cookidoo        # + Cookidoo-Upload
uv sync --extra whisper         # + Audio-Transkription (Social-Reels)
cp .env.example .env            # Keys/Optionen eintragen

ffmpeg wird für YouTube-/Social-Audio gebraucht (brew install ffmpeg).

In Claude Code einbinden

claude mcp add thermomix -- uv --directory /pfad/zu/thermomix-mcp run thermomix-mcp

Dann z. B.: „Mach mir aus dieser Chefkoch-URL ein Thermomix-Rezept."

Webhook — „aus jeder App teilen"

uv run thermomix-webhook        # startet auf 0.0.0.0:8787

Endpunkte:

• GET /health → Status

• POST /recipe mit {"url": "…", "caption": "…"(optional)} und Header X-Auth-Token: <WEBHOOK_TOKEN> → extrahiert, wandelt um, speichert die Karte, lädt (wenn konfiguriert) nach Cookidoo hoch. Rezeptlose Video-Posts → sofort 202 + Deep-Hunt im Hintergrund.

Für den Zugriff von unterwegs den Webhook über einen Tunnel freigeben (z. B. Tailscale Funnel oder Cloudflare Tunnel — feste HTTPS-URL, keine Portfreigabe). Ein iOS-Kurzbefehl im Teilen-Menü POSTet die geteilte URL dorthin. Vor jeder öffentlichen Exposure WEBHOOK_TOKEN setzen.

Konfiguration (.env)

Lizenz

MIT