Cookidoo MCP

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/vitaliemiron-cookidoo-mcp

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools

6 read · 7 write · 1 delete · 2 not yet classified

Secrets

2 (API keys, tokens or passwords)

Install scripts

Not scanned yet

Runs as

Python package

Tools (16)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• add_recipes_to_meal_plan

  Add one or more recipes to a Cookidoo meal-plan day. Mixed official IDs (for example r460132) and custom recipe ULIDs are supported when recipe_source is auto. Separate IDs with commas, spaces, or newlines. The updated day is returned after Cookidoo confirms the change. Args: date: Target day in YYYY-MM-DD format. recipe_ids: One or more Cookidoo recipe IDs. recipe_source: auto, official, or custom. dry_run: Validate and preview the exact calendar change without sending it to Cookidoo.

• calculate_annotation_position

  Calculate Cookidoo's offset and length for text inside a recipe step. Cookidoo uses JavaScript UTF-16 character positions, which differ from normal Python string indexes when text before the marker contains emoji. Use this tool for every TTS, MODE, INGREDIENT, and VOLUME annotation.

• connect_to_cookidoo

  Authenticate with Cookidoo and store the session. This tool must be called before using other Cookidoo tools. It will: 1. Load your Cookidoo credentials from the .env file 2. Normalize and validate the optional COOKIDOO_COUNTRY and COOKIDOO_LANGUAGE values (default ro/en) 3. Authenticate with the matching Cookidoo platform localization 4. Store the authenticated session for use by other tools Returns: str: Success message confirming connection Raises: ValueError: If credentials are missing from .env file Exception: If authentication fails

• copy_recipe_to_custom

  Copy an official Cookidoo recipe into the account's custom recipes. This is the supported way to obtain the full ingredients and instructions of an official recipe before translating or editing it. Set dry_run to true to validate and preview creation of the private copy without changing the account.

• generate_recipe_structure

  Generate and validate a recipe structure ready for upload to Cookidoo. This tool helps you structure your recipe data properly before uploading. It validates all fields and returns a JSON structure that can be used with the upload_custom_recipe tool. Always put weighing/adding ingredients in one step and the subsequent chopping, mixing, cooking, or kneading action in a separate step. Args: name: Recipe name (required) ingredients: Ingredients list, one per line or comma-separated steps: Cooking steps, one per line or numbered. Ingredient additions and machine actions mus…

• get_custom_recipe_details

  Get the full text content of a recipe in the account's custom recipes. Unlike get_recipe_details, this endpoint includes preparation instructions. It returns plain ingredient and instruction text; use the update tools to add or replace guided-cooking annotations.

• get_meal_plan_week

  Get Cookidoo's complete seven-day meal-plan window. Cookidoo normally omits empty days and returns custom recipes as bare IDs. This tool fills all seven days starting with the requested date and resolves custom recipe IDs to names, images, durations, and links. This matches the `?date=YYYY-MM-DD` parameter used by Cookidoo's web planner. Args: date: First day of the seven-day window, formatted YYYY-MM-DD.

• get_recipe_details

  Get detailed information about a specific recipe by its ID. Use this tool to get full details about a recipe for inspiration before creating your own custom recipe. You must be connected first using connect_to_cookidoo. Args: recipe_id: The Cookidoo recipe ID (e.g., "r59322", "r907015") Returns: str: Detailed recipe information including ingredients, steps, cooking time, etc. Raises: Exception: If not connected or if the recipe is not found

• get_shopping_list_ingredients

  Get Cookidoo shopping-list ingredients grouped by recipe. Args: recipe_id: Optional exact recipe ID from the shopping list. Omit it to return every recipe. include_owned: Include ingredients already marked as owned. Defaults to false so grocery workflows receive only products still needed. include_additional_items: Include manually added shopping-list items. Returns: JSON with `recipes` (each containing its own ingredients), a convenient flat `ingredients` list carrying recipe_id/recipe_name, manual `additional_items`, and summary counts.

• move_recipe_in_meal_plan

  Move one recipe from one Cookidoo calendar day to another. The recipe is added to the target first and then removed from the source. If removal fails, a newly-added target entry is rolled back. Args: recipe_id: Official or custom Cookidoo recipe ID. from_date: Existing day in YYYY-MM-DD format. to_date: New day in YYYY-MM-DD format. recipe_source: auto, official, or custom. dry_run: Validate and preview both calendar operations without sending either one to Cookidoo.

• remove_recipe_from_meal_plan

  Remove one recipe from a Cookidoo meal-plan day. Args: date: Calendar day in YYYY-MM-DD format. recipe_id: Official or custom Cookidoo recipe ID. recipe_source: auto, official, or custom. dry_run: Validate and preview the removal without sending it to Cookidoo.

• update_custom_recipe_ingredients

  Replace a custom recipe's ingredients. ingredients_json must be a JSON array. Each item may be plain ingredient text or an INGREDIENT object containing a VOLUME annotation. This partial update preserves the recipe's other fields. Set dry_run to true to validate and return the full replacement ingredient list without patching Cookidoo.

• update_custom_recipe_steps

  Replace a custom recipe's preparation steps. steps_json must be a JSON array. Each item may be plain step text or a STEP object containing TTS, MODE, and/or INGREDIENT annotations. This partial update preserves the recipe's other fields. Always use separate steps for weighing/adding ingredients and for the following cooking, mixing, chopping, or kneading action. A single step cannot contain both INGREDIENT and TTS/MODE annotations. Set dry_run to true to validate and return the full replacement step list without patching Cookidoo.

• upload_custom_recipe

  Upload a custom recipe to your Cookidoo account. This tool creates a brand new recipe from scratch on your Cookidoo account. Use 'generate_recipe_structure' first to validate your recipe data, then pass the resulting JSON to this tool. Args: recipe_json: The validated recipe JSON from generate_recipe_structure dry_run: Validate and preview the complete new recipe without creating it in Cookidoo. Returns: str: Success message with the created recipe ID

• upload_custom_recipe_image

  Upload a local image and attach it to a custom Cookidoo recipe. The file is converted to JPEG when necessary (including WebP), uploaded through Cookidoo's signed customer-recipe image flow, and attached with isImageOwnedByUser enabled. Cookidoo accepts images up to 10 MB. Args: recipe_id: The custom Cookidoo recipe ID. image_path: Absolute or user-relative path to a local image file. dry_run: Read and validate the local image, then preview the upload and recipe attachment without sending either request.

Compare and alternatives

Featured in

• Best MCP servers for translation

Signals

Stars

2

Forks

3

Open issues

0

Weekly downloads

78

Last commit

Jul 29, 2026 (3 months ago)

Last release

Jul 29, 2026 (3 months ago)

Last package publish

Jul 29, 2026 (3 months ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.vitaliemiron/cookidoo-mcp

Version

1.2.0

Auth

API key

Packages

pypi cookidoo-mcp

License

Apache-2.0

Repository

github.com/vitaliemiron/cookidoo-mcp

Website

vitaliemiron.github.io/cookidoo-mcp/

First seen

Oct 24, 2026

Last checked

Oct 24, 2026

Source

Official MCP Registrygithub-graphql