t
Clawdbot Skill Cookidoo
Verified@thekie
npx machina-cli add skill @thekie/cookidoo --openclawFiles (1)
SKILL.md
1.7 KB
Cookidoo
Access Cookidoo (Thermomix) recipes, shopping lists, and meal planning.
Required Credentials
| Variable | Required | Description |
|---|---|---|
COOKIDOO_EMAIL | ✅ Yes | Your Cookidoo account email |
COOKIDOO_PASSWORD | ✅ Yes | Your Cookidoo account password |
COOKIDOO_COUNTRY | Optional | Country code (default: DE) |
COOKIDOO_LANGUAGE | Optional | Language code (default: de-DE) |
Set in environment or ~/.config/atlas/cookidoo.env:
COOKIDOO_EMAIL=your@email.com
COOKIDOO_PASSWORD=yourpassword
Dependencies
pip install cookidoo-api
Tasks
List saved recipes
python scripts/cookidoo_cli.py recipes
Get weekly plan
python scripts/cookidoo_cli.py plan
Get shopping list from Cookidoo
python scripts/cookidoo_cli.py shopping
Search recipes
python scripts/cookidoo_cli.py search "Pasta"
Get recipe details
python scripts/cookidoo_cli.py recipe <recipe_id>
Get account info
python scripts/cookidoo_cli.py info
Options
--json— Output as JSON--limit N— Limit results (default: 10)
Integration Ideas
- Sync Cookidoo shopping list → Bring! app
- Suggest recipes based on what's in season
- Weekly meal planning assistance
- Export ingredients for selected recipes
Notes
- Requires active Cookidoo subscription
- API is unofficial — may break with Cookidoo updates
- Store credentials securely (not in skill folder)
Overview
This skill connects to Cookidoo via the unofficial cookidoo-api Python package to view recipes, weekly plans, and favorites, and to sync ingredients to shopping lists. It requires Cookidoo credentials and notes that the API is unofficial and may change. Use it to surface saved recipes, plan meals, and export shopping data.
How This Skill Works
Authenticate with COOKIDOO_EMAIL and COOKIDOO_PASSWORD (optionally COOKIDOO_COUNTRY and COOKIDOO_LANGUAGE). The unofficial API powers scripts like recipes, plan, shopping, search, recipe <id>, and info to fetch data, which the CLI prints or returns in JSON if requested.
When to Use It
- When you want to view your saved Cookidoo recipes or favorites.
- When you need your weekly Cookidoo plan and its shopping list.
- When you want to search for recipes by keyword (e.g., 'Pasta').
- When you need a detailed view of a specific recipe by ID.
- When you want to export or sync Cookidoo ingredients to another shopping app.
Quick Start
- Step 1: pip install cookidoo-api
- Step 2: Set up environment variables for COOKIDOO_EMAIL and COOKIDOO_PASSWORD (and optional COOKIDOO_COUNTRY/COOKIDOO_LANGUAGE) in ~/.config/atlas/cookidoo.env
- Step 3: Run commands like 'python scripts/cookidoo_cli.py recipes', 'plan', 'shopping', 'search "Pasta"', 'recipe <recipe_id>', or 'info'
Best Practices
- Store COOKIDOO_EMAIL and COOKIDOO_PASSWORD securely (not in the skill folder).
- Set COOKIDOO_COUNTRY and COOKIDOO_LANGUAGE to match your region for accurate results.
- Install the official cookidoo-api package before using the tool (pip install cookidoo-api).
- Be aware the API is unofficial and may break with Cookidoo updates; validate results.
- Use --json for machine-friendly output and to enable programmatic integration.
Example Use Cases
- Fetch your weekly plan and the corresponding shopping list for next week.
- Search for 'Pasta' recipes and pull details for the top matches.
- List saved recipes and open the details for a chosen recipe_id.
- Sync ingredients from your Cookidoo shopping list to a Bring! app or other tool.
- Retrieve account info to verify credentials and subscription status.
Frequently Asked Questions
Add this skill to your agents
