v1.8.2

What's Changed

Docker Image

docker pull ghcr.io/mdlopresti/mealie-mcp:1.8.2

See README for configuration instructions.

v1.8.1

What's Changed

Docker Image

docker pull ghcr.io/mdlopresti/mealie-mcp:1.8.1

See README for configuration instructions.

v1.8.0

What's Changed

Added

• Added mealie_categories_list MCP tool to list all categories (#21)
• Added mealie_categories_create MCP tool to create new categories (#21)
• Added mealie_categories_get MCP tool to get category by ID (#21)
• Added get_category method to MealieClient for retrieving category details (#21)
• Added comprehensive test coverage for all category operations (#21)
• Added mealie_tags_list MCP tool to list all tags (#22)
• Added mealie_tags_create MCP tool to create new tags (#22)
• Added mealie_tags_get MCP tool to get tag by ID (#22)
• Added get_tag method to MealieClient for retrieving tag details (#22)
• Added comprehensive test coverage for all tag operations (#22)
• Added mealie_tools_list MCP tool to list all kitchen tools (#23)
• Added mealie_tools_create MCP tool to create new kitchen tools (#23)
• Added mealie_tools_get MCP tool to get kitchen tool by ID (#23)
• Added create_tool and get_tool methods to MealieClient (#23)
• Added comprehensive test coverage for all kitchen tool operations (#23)
• Added mealie_foods_create MCP tool to create new foods (#25)
• Added create_food method to MealieClient for creating food items (#25)
• Added comprehensive test coverage for food creation (#25)
• Added mealie_units_create MCP tool to create new units (#26)
• Enhanced create_unit method to MealieClient with description and abbreviation parameters (#26)
• Added comprehensive test coverage for unit creation (#26)
• Added complete cookbooks management with full CRUD operations (#24)
• Added mealie_cookbooks_list, mealie_cookbooks_create, mealie_cookbooks_get, mealie_cookbooks_update, and mealie_cookbooks_delete MCP tools (#24)
• Created src/tools/cookbooks.py with cookbook management functions (#24)
• Added list_cookbooks, create_cookbook, get_cookbook, update_cookbook, and delete_cookbook methods to MealieClient (#24)
• Added comprehensive test coverage for all cookbook operations (#24)
• Added recipe comments management with full CRUD operations (#27)
• Created src/tools/comments.py with 5 comment management functions (#27)
• Added get_recipe_comments, create_comment, get_comment, update_comment, and delete_comment methods to MealieClient (#27)
• Added 5 MCP tools for comment management: mealie_comments_get_recipe, create, get, update, delete (#27)
• Added comprehensive test coverage for all comment operations (#27)
• Added recipe timeline events management with full CRUD operations (#28)
• Created src/tools/timeline.py with 6 timeline event management functions (#28)
• Added list_timeline_events, get_timeline_event, create_timeline_event, update_timeline_event, delete_timeline_event, and update_timeline_event_image methods to MealieClient (#28)
• Added 6 MCP tools for timeline management: mealie_timeline_list, create, get, update, delete, update_image (#28)
• Added comprehensive test coverage for all timeline operations (#28)

Impact

• Completes full CRUD functionality for all organizers (categories, tags, and kitchen tools)
• Enables automated recipe organization workflows with complete organizer management
• Allows programmatic category, tag, and tool management for bulk operations
• Enables programmatic creation of food items for recipe import workflows (#25)
• Enables programmatic creation of measurement units for recipe import workflows (#26)
• Enables cookbook management for organizing recipes into themed collections (#24)
• Supports meal planning workflows with cookbook-based recipe organization (#24)
• Enables tracking of when recipes were made and building cooking history analytics (#28)
• Supports recipe popularity tracking and visual timeline of cooking history (#28)
• Enables recipe iteration tracking through comments (#27)
• Supports collaborative recipe development with comment management (#27)
• Enables kitchen tool management during recipe imports
• Provides complete foundation for recipe organization automation

Docker Image

docker pull ghcr.io/mdlopresti/mealie-mcp:1.8.0

See README for configuration instructions.

v1.7.2

What's Changed

Fixed

• Fixed mealie_foods_update MCP tool wrapper to use label_id parameter instead of label (#17)
• Completed the fix from #16 by updating server.py to match the updated signature in client.py and foods.py

Impact

• MCP tool now properly accepts label_id parameter for assigning labels to foods
• Resolves validation error when calling mealie_foods_update with label_id argument

Docker Image

docker pull ghcr.io/mdlopresti/mealie-mcp:1.7.2

See README for configuration instructions.

v1.7.1

What's Changed

Fixed

• Fixed update_food method to use PUT instead of PATCH (#16)
• Fixed update_food to use label_id parameter instead of label (#16)
• Fixed update_food to use correct API field labelId instead of label (#16)
• Implemented GET-then-PUT pattern in update_food to preserve all food fields (#16)
• Updated foods_update tool function to match new signature with label_id parameter (#16)

Impact

• Enables programmatic label assignment to foods
• Supports shopping list organization by label category
• Enables bulk food categorization workflows
• Enables automated food organization

Docker Image

docker pull ghcr.io/mdlopresti/mealie-mcp:1.7.1

See README for configuration instructions.

v1.6.9

What's Changed

Added

• Comprehensive test suite for client initialization and error parsing
  • 20 new tests for MealieClient basic functionality
  • Tests for environment variable configuration and URL building
  • Tests for error message parsing (422, 500, 409, 404)
  • Tests for MealieAPIError exception handling
  • Tests for context manager support

Changed

• Improved code coverage from 14% to 15%
• client.py coverage improved from 32% to 36%
• Total test count increased from 54 to 74 tests

Docker Image

docker pull ghcr.io/mdlopresti/mealie-mcp:1.6.9

See README for configuration instructions.

v1.6.1

What's Changed

Added

• Recipe Image Upload from URL - mealie_recipes_upload_image_from_url(slug, image_url)
  • Downloads image from provided URL and uploads to existing recipe
  • Automatic image format detection (jpg, png, webp)
  • Mealie handles resizing and optimization automatically
  • Enables easy image addition without manual download/upload workflow

Technical Implementation

• Added upload_recipe_image_from_url() method to MealieClient
• Uses multipart/form-data with PUT /api/recipes/{slug}/image endpoint
• Integrated httpx for image download with proper error handling
• Added recipes_upload_image_from_url() tool in tools/recipes.py
• Exposed as mealie_recipes_upload_image_from_url MCP tool

Use Cases

• Add images to recipes imported from plain text or JSON
• Update recipe images from authoritative sources (e.g., Anova Culinary)
• Batch image updates for recipe collections
• Preserve visual context from original recipe sources

Docker Image

docker pull ghcr.io/mdlopresti/mealie-mcp:1.6.1

See README for configuration instructions.

v1.6.0

What's Changed

Added

High-Priority Recipe Management Features

• Recipe Duplication - mealie_recipes_duplicate(slug, new_name?)

  • Create variations of existing recipes
  • Useful for meal prep adaptations and recipe experimentation

• Last Made Tracking - mealie_recipes_update_last_made(slug, timestamp?)

  • Track when recipes were last prepared
  • Enables meal rotation planning and freshness tracking

• Bulk URL Import - mealie_recipes_create_from_urls_bulk(urls, include_tags)

  • Import multiple recipes from URLs at once
  • More efficient than sequential one-at-a-time imports

• Bulk Recipe Actions - Batch operations for recipe management:

  • mealie_recipes_bulk_tag(recipe_ids, tags) - Add tags to multiple recipes
  • mealie_recipes_bulk_categorize(recipe_ids, categories) - Categorize multiple recipes
  • mealie_recipes_bulk_delete(recipe_ids) - Delete multiple recipes at once
  • mealie_recipes_bulk_export(recipe_ids, format) - Export recipe batches
  • mealie_recipes_bulk_update_settings(recipe_ids, settings) - Update settings across recipes

Meal Plan Rules (Automated Planning)

• Full CRUD for Meal Plan Rules - /api/households/mealplans/rules endpoints:
  • mealie_mealplan_rules_list() - List all meal planning rules
  • mealie_mealplan_rules_get(rule_id) - Get specific rule details
  • mealie_mealplan_rules_create(name, entry_type, tags?, categories?) - Create automation rules
  • mealie_mealplan_rules_update(rule_id, ...) - Update existing rules
  • mealie_mealplan_rules_delete(rule_id) - Delete rules
• Enables automated meal plan generation with preference-based filtering

Foods & Units Management

• Foods Management - Complete CRUD operations for ingredient database:

  • mealie_foods_list(page, per_page) - Browse all foods with pagination
  • mealie_foods_get(food_id) - Get food details
  • mealie_foods_update(food_id, name?, description?, label?) - Update food entries
  • mealie_foods_delete(food_id) - Delete foods
  • mealie_foods_merge(from_food_id, to_food_id) - Merge duplicate foods across recipes

• Units Management - Complete CRUD operations for measurement units:

  • mealie_units_list(page, per_page) - Browse all units with pagination
  • mealie_units_get(unit_id) - Get unit details
  • mealie_units_update(unit_id, name?, description?, abbreviation?) - Update units
  • mealie_units_delete(unit_id) - Delete units
  • mealie_units_merge(from_unit_id, to_unit_id) - Merge duplicate units across recipes

Organizers Management (Categories, Tags, Tools)

• Categories Management:

  • mealie_categories_update(category_id, name?, slug?) - Update category details
  • mealie_categories_delete(category_id) - Delete categories

• Tags Management:

  • mealie_tags_update(tag_id, name?, slug?) - Update tag details
  • mealie_tags_delete(tag_id) - Delete tags

• Tools Management:

  • mealie_tools_update(tool_id, name?, slug?) - Update cooking tool details
  • mealie_tools_delete(tool_id) - Delete tools

Shopping List Enhancements

• Recipe Ingredient Removal - mealie_shopping_delete_recipe_from_list(item_id, recipe_id)
  • Remove specific recipe's ingredients from shopping list
  • Better control over shopping list composition

Experimental Features

• Recipe from Image (AI) - mealie_recipes_create_from_image(image_data, extension)
  • AI-generated recipes from photos (experimental)
  • Requires Mealie instance with AI features enabled

Technical Implementation

• Added 46 new MCP tools across 9 feature categories
• Created new tool modules: tools/foods.py, tools/organizers.py
• Extended tools/recipes.py, tools/mealplans.py, tools/shopping.py
• Added 24 new client methods to client.py
• Comprehensive error handling and validation across all new endpoints

Use Cases Enabled

• Data Quality: Merge duplicate foods/units, clean up organizers
• Bulk Operations: Tag/categorize/delete/export recipes in batches
• Automation: Set up meal planning rules for automated suggestions
• Workflow Efficiency: Duplicate recipes for variations, track last made dates
• Import Scale: Import multiple recipe URLs simultaneously

Docker Image

docker pull ghcr.io/mdlopresti/mealie-mcp:1.6.0

See README for configuration instructions.

v1.5.0

What's Changed

Added

• orgURL and image support in mealie_recipes_update tool
• New org_url parameter to set/update original recipe URL
• New image parameter to set/update recipe image identifier
• Enables preserving source attribution when modifying recipes

Changed

• recipes_update() function signature updated with org_url and image parameters
• mealie_recipes_update() MCP tool now exposes orgURL and image fields

Docker Image

docker pull ghcr.io/mdlopresti/mealie-mcp:1.5.0

See README for configuration instructions.

v1.4.14

🐛 Bug Fix

Fixed mealie_shopping_generate_from_mealplan Pagination Handling

Problem: The tool was returning "No meal plans found for the specified date range" even when meal plans existed.

Root Cause: The Mealie API returns paginated responses as {"items": [...], "page": 1, "total": N, ...}, but the tool only expected direct list responses.

Solution: Added proper pagination handling to extract the items array from paginated responses while maintaining backward compatibility with direct lists.

Impact:

• ✅ Shopping lists can now be generated directly from meal plans
• ✅ Full structured ingredient data (quantity, unit, food, notes)
• ✅ Automatic consolidation of duplicate ingredients
• ✅ Supports recipe scaling, unit conversions, and nutrition tracking

Testing:

• Tested with Dec 19-21 meal plan (6 recipes)
• Successfully created shopping list with 38 structured ingredient items
• All items properly formatted with Unicode fractions (¹/₃, ¹/₄, ½)

Changes

• src/tools/shopping.py: Handle paginated meal plan responses (commit: cfc0e3f)

Docker Image

docker pull ghcr.io/mdlopresti/mealie-mcp:v1.4.14

See README for configuration instructions.