cookidoo-mcp-server 1.0.0__tar.gz

cookidoo_mcp_server-1.0.0/.gitignore

@@ -0,0 +1,27 @@
+# Virtual environment
+venv/
+.venv/
+
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+
+# Local credentials
+.env.mcp
+
+# Generated bundles
+*.mcpb
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Temp files
+~$*
+*.tmp
+
+# IDE
+.idea/
+.vscode/
+*.swp

cookidoo_mcp_server-1.0.0/.mcpbignore

@@ -0,0 +1,9 @@
+.git/
+.env*
+.venv/
+venv/
+__pycache__/
+*.pyc
+*.mcpb
+Makefile
+README.md

cookidoo_mcp_server-1.0.0/Makefile

@@ -0,0 +1,14 @@
+.PHONY: build validate clean
+
+BUNDLE := cookidoo-mcp.mcpb
+
+validate:
+	uv lock --check
+	python3 -m json.tool manifest.json >/dev/null
+	npx --yes @anthropic-ai/mcpb validate manifest.json
+
+build: validate
+	npx --yes @anthropic-ai/mcpb pack . $(BUNDLE)
+
+clean:
+	rm -f $(BUNDLE)

cookidoo_mcp_server-1.0.0/PKG-INFO

@@ -0,0 +1,112 @@
+Metadata-Version: 2.5
+Name: cookidoo-mcp-server
+Version: 1.0.0
+Summary: MCP server for Cookidoo recipes, shopping lists, collections, and meal planning
+Project-URL: Homepage, https://trueforge.studio
+Project-URL: Repository, https://github.com/detef10/cookidoo-mcp
+Author-email: Joaquin Nunez <joaquin@ayhungry.com>
+License-Expression: MIT
+Keywords: cookidoo,mcp,meal-planning,recipes,thermomix
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.12
+Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: cookidoo-api==0.17.2
+Requires-Dist: mcp==1.0.0
+Description-Content-Type: text/markdown
+
+# Cookidoo MCP Server
+
+An MCP server for the Cookidoo (Thermomix) platform.
+
+## MCPB bundle for Claude Desktop
+
+This project includes an MCP Bundle (`.mcpb`) manifest that runs the server
+without Docker. The bundle asks for Cookidoo email and password during
+installation. Country and language are optional and default to `ES` and
+`es-ES`; examples such as `DE` / `de-DE` can be entered when needed.
+
+Install the MCPB CLI and create the bundle from this directory:
+
+```bash
+make build
+```
+
+The command validates the manifest and dependencies, then creates
+`cookidoo-mcp.mcpb`. It requires `uv` and `npx`.
+
+Then open the generated `.mcpb` file with Claude Desktop. It will install the
+server and securely store the sensitive password configuration.
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `search_recipes` | Search recipes by keyword, ingredients, rating, or difficulty |
+| `get_recipe_details` | Get full recipe details by ID |
+| `get_user_info` | View your account profile |
+| `get_active_subscription` | View active subscription status |
+| `get_managed_collections` | List managed collections |
+| `get_custom_collections` | List custom collections |
+| `get_collection_counts` | Count custom and managed collections |
+| `create_custom_collection` | Create a custom collection |
+| `delete_custom_collection` | Delete a custom collection |
+| `add_recipe_to_collection` | Add recipe to a custom collection |
+| `remove_recipe_from_collection` | Remove recipe from a custom collection |
+| `add_managed_collection` | Add a managed collection |
+| `remove_managed_collection` | Remove a managed collection |
+| `get_custom_recipe` | View a custom recipe |
+| `create_custom_recipe_from` | Copy a recipe as custom (premium may be required) |
+| `delete_custom_recipe` | Delete a custom recipe |
+| `get_shopping_list` | View recipes in shopping list |
+| `get_ingredient_items` | View individual ingredient items |
+| `add_recipes_to_shopping_list` | Add recipe ingredients to shopping list |
+| `remove_recipes_from_shopping_list` | Remove recipe ingredients from shopping list |
+| `add_custom_recipes_to_shopping_list` | Add custom recipe ingredients (premium may be required) |
+| `remove_custom_recipes_from_shopping_list` | Remove custom recipe ingredients |
+| `get_additional_items` | View manual shopping-list items |
+| `add_additional_items` | Add manual shopping-list items |
+| `rename_additional_items` | Rename manual shopping-list items |
+| `set_additional_items_owned` | Mark manual items owned or not owned |
+| `remove_additional_items` | Remove manual shopping-list items |
+| `get_planned_recipes` | View meal planner for date range |
+| `schedule_recipes` | Add recipes to the meal planner for a date |
+| `unschedule_recipe` | Remove a recipe from the meal planner date |
+| `schedule_custom_recipes` | Schedule custom recipes (premium may be required) |
+| `unschedule_custom_recipe` | Remove custom recipe from calendar |
+| `tick_off_items` | Mark ingredient items as owned |
+| `untick_items` | Mark ingredient items as not owned |
+| `clear_shopping_list` | Clear the entire shopping list |
+
+### Recipe Search Filters
+
+`search_recipes` accepts these optional filters in addition to `query` and `page`:
+
+| Parameter | Values | Behavior |
+|-----------|--------|----------|
+| `include_ingredients` | Array of ingredient names in the Cookidoo locale | Every result must include all listed ingredients. |
+| `exclude_ingredients` | Array of ingredient names in the Cookidoo locale | Results containing any listed ingredient are omitted. |
+| `min_rating` | Number from `0` to `5` | Returns recipes with at least that star rating. |
+| `difficulty` | `easy`, `medium`, or `advanced` | Filters by Cookidoo's internal difficulty values. |
+| `sort_by` | `relevance`, `name`, `shortest_preparation_time`, `shortest_total_time`, `newest`, `best_rated`, `trending` | Sorts results using Cookidoo's official search indexes. |
+| `countries` | Country codes such as `de`, `at`, `ch`, `it` | Limits recipes by country of origin. Defaults to configured country. |
+| `languages` | Language codes such as `de`, `en`, `es`, `it` | Limits recipes by available language. |
+| `categories` | `pasta_and_rice`, `main_dishes_meat`, `main_dishes_fish`, `main_dishes_vegetarian`, and other schema values | Limits recipes to category names used by the MCP. |
+| `tm_models` | `TM31`, `TM5`, `TM6`, `TM7` | Includes recipes compatible with any selected model. |
+| `accessories` | `blade_cover`, `cutter`, `cooking_station`, `peeler`, `thermomix_sensor` | Includes recipes requiring any selected accessory. |
+| `max_preparation_time` | `15`, `30`, `45` | Maximum preparation time in minutes. |
+| `max_total_time` | `15`, `30`, `45` | Maximum total time in minutes. |
+| `portions` | `1`, `2`, `4`, `6`, `8` | Exact portion count; `8` means eight or more. |
+| `tags` | Cookidoo tag values | Filters recipe tags. |
+| `dietary` | Cookidoo dietary values | Filters dietary labels. |
+| `free_of_ingredients` | Values such as `gluten_free`, `lactose_free`, `nut_free` | Filters recipes free of selected ingredients. |
+| `ingredient_categories` | Cookidoo ingredient-category values | Filters ingredient categories. |
+| `nutrition_goals` | Cookidoo nutrition-goal values | Filters nutrition goals. |
+| `cultural` | Cookidoo cultural/origin values | Filters cultural recipe origin. |
+| `health_evaluation` | Cookidoo health-evaluation values | Filters health evaluations. |
+| `recipe_characteristics` | Cookidoo recipe-characteristic values | Filters recipe characteristics. |
+
+## Credits
+
+Built on top of the [cookidoo-api](https://github.com/miaucl/cookidoo-api) package by miaucl.

cookidoo_mcp_server-1.0.0/README.md

@@ -0,0 +1,94 @@
+# Cookidoo MCP Server
+
+An MCP server for the Cookidoo (Thermomix) platform.
+
+## MCPB bundle for Claude Desktop
+
+This project includes an MCP Bundle (`.mcpb`) manifest that runs the server
+without Docker. The bundle asks for Cookidoo email and password during
+installation. Country and language are optional and default to `ES` and
+`es-ES`; examples such as `DE` / `de-DE` can be entered when needed.
+
+Install the MCPB CLI and create the bundle from this directory:
+
+```bash
+make build
+```
+
+The command validates the manifest and dependencies, then creates
+`cookidoo-mcp.mcpb`. It requires `uv` and `npx`.
+
+Then open the generated `.mcpb` file with Claude Desktop. It will install the
+server and securely store the sensitive password configuration.
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `search_recipes` | Search recipes by keyword, ingredients, rating, or difficulty |
+| `get_recipe_details` | Get full recipe details by ID |
+| `get_user_info` | View your account profile |
+| `get_active_subscription` | View active subscription status |
+| `get_managed_collections` | List managed collections |
+| `get_custom_collections` | List custom collections |
+| `get_collection_counts` | Count custom and managed collections |
+| `create_custom_collection` | Create a custom collection |
+| `delete_custom_collection` | Delete a custom collection |
+| `add_recipe_to_collection` | Add recipe to a custom collection |
+| `remove_recipe_from_collection` | Remove recipe from a custom collection |
+| `add_managed_collection` | Add a managed collection |
+| `remove_managed_collection` | Remove a managed collection |
+| `get_custom_recipe` | View a custom recipe |
+| `create_custom_recipe_from` | Copy a recipe as custom (premium may be required) |
+| `delete_custom_recipe` | Delete a custom recipe |
+| `get_shopping_list` | View recipes in shopping list |
+| `get_ingredient_items` | View individual ingredient items |
+| `add_recipes_to_shopping_list` | Add recipe ingredients to shopping list |
+| `remove_recipes_from_shopping_list` | Remove recipe ingredients from shopping list |
+| `add_custom_recipes_to_shopping_list` | Add custom recipe ingredients (premium may be required) |
+| `remove_custom_recipes_from_shopping_list` | Remove custom recipe ingredients |
+| `get_additional_items` | View manual shopping-list items |
+| `add_additional_items` | Add manual shopping-list items |
+| `rename_additional_items` | Rename manual shopping-list items |
+| `set_additional_items_owned` | Mark manual items owned or not owned |
+| `remove_additional_items` | Remove manual shopping-list items |
+| `get_planned_recipes` | View meal planner for date range |
+| `schedule_recipes` | Add recipes to the meal planner for a date |
+| `unschedule_recipe` | Remove a recipe from the meal planner date |
+| `schedule_custom_recipes` | Schedule custom recipes (premium may be required) |
+| `unschedule_custom_recipe` | Remove custom recipe from calendar |
+| `tick_off_items` | Mark ingredient items as owned |
+| `untick_items` | Mark ingredient items as not owned |
+| `clear_shopping_list` | Clear the entire shopping list |
+
+### Recipe Search Filters
+
+`search_recipes` accepts these optional filters in addition to `query` and `page`:
+
+| Parameter | Values | Behavior |
+|-----------|--------|----------|
+| `include_ingredients` | Array of ingredient names in the Cookidoo locale | Every result must include all listed ingredients. |
+| `exclude_ingredients` | Array of ingredient names in the Cookidoo locale | Results containing any listed ingredient are omitted. |
+| `min_rating` | Number from `0` to `5` | Returns recipes with at least that star rating. |
+| `difficulty` | `easy`, `medium`, or `advanced` | Filters by Cookidoo's internal difficulty values. |
+| `sort_by` | `relevance`, `name`, `shortest_preparation_time`, `shortest_total_time`, `newest`, `best_rated`, `trending` | Sorts results using Cookidoo's official search indexes. |
+| `countries` | Country codes such as `de`, `at`, `ch`, `it` | Limits recipes by country of origin. Defaults to configured country. |
+| `languages` | Language codes such as `de`, `en`, `es`, `it` | Limits recipes by available language. |
+| `categories` | `pasta_and_rice`, `main_dishes_meat`, `main_dishes_fish`, `main_dishes_vegetarian`, and other schema values | Limits recipes to category names used by the MCP. |
+| `tm_models` | `TM31`, `TM5`, `TM6`, `TM7` | Includes recipes compatible with any selected model. |
+| `accessories` | `blade_cover`, `cutter`, `cooking_station`, `peeler`, `thermomix_sensor` | Includes recipes requiring any selected accessory. |
+| `max_preparation_time` | `15`, `30`, `45` | Maximum preparation time in minutes. |
+| `max_total_time` | `15`, `30`, `45` | Maximum total time in minutes. |
+| `portions` | `1`, `2`, `4`, `6`, `8` | Exact portion count; `8` means eight or more. |
+| `tags` | Cookidoo tag values | Filters recipe tags. |
+| `dietary` | Cookidoo dietary values | Filters dietary labels. |
+| `free_of_ingredients` | Values such as `gluten_free`, `lactose_free`, `nut_free` | Filters recipes free of selected ingredients. |
+| `ingredient_categories` | Cookidoo ingredient-category values | Filters ingredient categories. |
+| `nutrition_goals` | Cookidoo nutrition-goal values | Filters nutrition goals. |
+| `cultural` | Cookidoo cultural/origin values | Filters cultural recipe origin. |
+| `health_evaluation` | Cookidoo health-evaluation values | Filters health evaluations. |
+| `recipe_characteristics` | Cookidoo recipe-characteristic values | Filters recipe characteristics. |
+
+## Credits
+
+Built on top of the [cookidoo-api](https://github.com/miaucl/cookidoo-api) package by miaucl.

cookidoo_mcp_server-1.0.0/manifest.json

@@ -0,0 +1,67 @@
+{
+  "manifest_version": "0.4",
+  "name": "cookidoo-mcp",
+  "display_name": "Cookidoo MCP",
+  "version": "1.0.0",
+  "description": "Search Cookidoo recipes, manage shopping lists and collections, and plan meals.",
+  "author": {
+    "name": "Joaquin Nunez"
+  },
+  "server": {
+    "type": "uv",
+    "entry_point": "mcp_server.py",
+    "mcp_config": {
+      "command": "uv",
+      "args": [
+        "run",
+        "--directory",
+        "${__dirname}",
+        "mcp_server.py"
+      ],
+      "env": {
+        "COOKIDOO_EMAIL": "${user_config.email}",
+        "COOKIDOO_PASSWORD": "${user_config.password}",
+        "COOKIDOO_COUNTRY": "${user_config.country}",
+        "COOKIDOO_LANGUAGE": "${user_config.language}"
+      }
+    }
+  },
+  "user_config": {
+    "email": {
+      "type": "string",
+      "title": "Cookidoo email",
+      "description": "The email address used for your Cookidoo account.",
+      "required": true
+    },
+    "password": {
+      "type": "string",
+      "title": "Cookidoo password",
+      "description": "The password used for your Cookidoo account.",
+      "sensitive": true,
+      "required": true
+    },
+    "country": {
+      "type": "string",
+      "title": "Cookidoo country",
+      "description": "Optional country code. Default: ES. Examples: ES, DE, AT, CH, IT, GB.",
+      "default": "ES",
+      "required": false
+    },
+    "language": {
+      "type": "string",
+      "title": "Cookidoo language",
+      "description": "Optional locale. Default: es-ES. Examples: es-ES, de-DE, en-GB, it-IT.",
+      "default": "es-ES",
+      "required": false
+    }
+  },
+  "compatibility": {
+    "platforms": ["darwin", "linux", "win32"],
+    "runtimes": {
+      "python": ">=3.12"
+    }
+  },
+  "keywords": ["cookidoo", "thermomix", "recipes", "meal-planning"],
+  "license": "MIT",
+  "tools_generated": true
+}