Mealie MCP Server

A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yourMealierecipe database through clients like Claude Desktop.

- Python 3.12+
- Running Mealie instance with API key
- Package manageruv

fastmcp install src/server.py \ --env-var MEALIE_BASE_URL=https://your-mealie-instance.com \ --env-var MEALIE_API_KEY=your-mealie-api-key

{ "mcpServers": { "mealie-mcp-server": { "command": "uvx", "args": ["git+https://github.com/rldiao/mealie-mcp-server"], "env": { "MEALIE_BASE_URL": "https://your-mealie-instance.com", "MEALIE_API_KEY": "your-mealie-api-key" } } } }

Restart Claude Desktop to load the server.

"Search for chicken recipes" "Create a new recipe for pasta carbonara" "Duplicate my lasagna recipe" "Mark the meatloaf recipe as made today" "Upload an image for the chocolate cake recipe"

"Create a shopping list for this week" "Add eggs and milk to my shopping list" "Add all ingredients from the lasagna recipe to my shopping list" "Check off milk on my shopping list" "Delete all checked items from my shopping list"

"Show me all my recipe categories" "Create a new tag called 'Quick Meals'" "Find all recipes tagged with 'healthy'" "Show me categories that have no recipes"

"Find recipes that have both 'quick' AND 'healthy' tags" "Search for breakfast recipes containing 'eggs'" "Show me all vegetarian dinner recipes"

- get_recipes- List/search recipes with advanced filtering
- get_recipe_detailed- Get complete recipe details
- get_recipe_concise- Get recipe summary
- create_recipe- Create new recipe (flat or structured ingredients)
- create_recipe_full- Create a recipe with full content in one call
- update_recipe- Update recipe (full replacement)
- patch_recipe- Update specific fields only
- duplicate_recipe- Clone a recipe
- mark_recipe_last_made- Update last made timestamp
- set_recipe_image_from_url- Set image from URL
- upload_recipe_image_file- Upload image file
- upload_recipe_asset_file- Upload document/asset
- delete_recipe- Delete recipe

- get_shopping_lists- List all shopping lists
- create_shopping_list- Create new list
- get_shopping_list- Get list by ID
- delete_shopping_list- Delete list
- add_recipe_to_shopping_list- Add recipe ingredients
- remove_recipe_from_shopping_list- Remove recipe ingredients
- get_shopping_list_items- List all items
- get_shopping_list_item- Get item by ID
- create_shopping_list_item- Create single item
- create_shopping_list_items_bulk- Create multiple items
- update_shopping_list_item- Update item (preserves fields)
- update_shopping_list_items_bulk- Update multiple items
- delete_shopping_list_item- Delete single item
- delete_shopping_list_items_bulk- Delete multiple items

- get_categories- List/search categories
- get_empty_categories- Find unused categories
- create_category- Create new category
- get_category- Get by ID
- get_category_by_slug- Get by slug
- update_category- Update category
- delete_category- Delete category

- get_tags- List/search tags
- get_empty_tags- Find unused tags
- create_tag- Create new tag
- get_tag- Get by ID
- get_tag_by_slug- Get by slug
- update_tag- Update tag
- delete_tag- Delete tag

- get_foods- List/search foods (resolve ids for structured ingredients)
- create_food- Create a new food
- get_food- Get by ID
- update_food- Update food
- delete_food- Delete food

- get_units- List/search units
- create_unit- Create a new unit
- get_unit- Get by ID
- update_unit- Update unit
- delete_unit- Delete unit

- get_tools- List/search recipe tools (includeshouseholdsWithTool)
- create_tool- Create a new tool
- get_tool- Get by ID
- get_tool_by_slug- Get by slug
- update_tool- Update tool
- delete_tool- Delete tool

- get_all_mealplans- List meal plans
- create_mealplan- Create meal plan entry
- create_mealplan_bulk- Create multiple entries
- get_todays_mealplan- Get today's meals

Total: 62 toolsproviding comprehensive Mealie API coverage

git clone <repository-url> cd mealie-mcp-server

cp .env.template .env # Edit .env with your Mealie instance details

mealie-mcp-server/ ├── src/ │ ├── mealie/ # API client mixins │ │ ├── client.py # Base HTTP client │ │ ├── recipe.py # Recipe operations │ │ ├── shopping_list.py # Shopping list operations │ │ ├── categories.py # Category operations │ │ ├── tags.py # Tag operations │ │ ├── mealplan.py # Meal plan operations │ │ └── __init__.py # MealieFetcher aggregator │ ├── tools/ # MCP tool definitions │ │ ├── recipe_tools.py │ │ ├── shopping_list_tools.py │ │ ├── categories_tools.py │ │ ├── tags_tools.py │ │ ├── mealplan_tools.py │ │ └── __init__.py │ ├── models/ # Pydantic models │ ├── server.py # MCP server entry point │ └── prompts.py # Server prompts ├── CHANGELOG.md # Version history └── README.md

When filtering recipes, youmust use slugs or UUIDs, not display names:

"Get recipes with tags=['quick-meals', 'healthy']"

"Get recipes with tags=['Quick Meals', 'Healthy']"

Useget_tags()orget_categories()first to find the correct slugs.

When updating shopping list items, the server automatically preserves all existing fields. You only need to specify the fields you want to change:

# Only updates 'checked' field, preserves note, quantity, etc. update_shopping_list_item(item_id="...", checked=True)

None currently! All features have been tested end-to-end with Claude Desktop.

SeeCHANGELOG.mdfor a detailed list of changes and version history.

This project is licensed under the MIT License - see theLICENSEfile for details.

- Mealie- The recipe management system
- FastMCP- The MCP framework

- Check theCHANGELOG.mdfor recent updates
- Review the Mealie API documentation
- Open an issue on GitHub

- Mealie Documentation
- MCP Protocol Specification
- Claude Desktop

Sync Calendars, Scheduling Links, AI Executive Scheduling Assistant, Unified Calendar