Mealie MCP Server

A Model Context Protocol (MCP) server that enables AI assistants to interact with Mealie for recipe management, meal planning, and shopping lists.

Features

Tools (28 total)

Recipes

• mealie_recipes_search - Search recipes by name, tags, or categories

• mealie_recipes_get - Get full recipe details including ingredients and instructions

• mealie_recipes_list - List all recipes with pagination

• mealie_recipes_create - Create a new recipe

• mealie_recipes_create_from_url - Import recipe by scraping a URL

• mealie_recipes_update - Update an existing recipe

• mealie_recipes_delete - Delete a recipe

Meal Planning

• mealie_mealplans_list - List meal plans for a date range

• mealie_mealplans_today - Get today's meals

• mealie_mealplans_get - Get specific meal plan entry

• mealie_mealplans_get_date - Get meals for a specific date

• mealie_mealplans_create - Create meal plan entry

• mealie_mealplans_update - Update meal plan entry

• mealie_mealplans_delete - Delete meal plan entry

• mealie_mealplans_random - Get random meal suggestion

Shopping Lists

• mealie_shopping_lists_list - List all shopping lists

• mealie_shopping_lists_get - Get shopping list with items

• mealie_shopping_lists_create - Create new shopping list

• mealie_shopping_lists_delete - Delete shopping list

• mealie_shopping_items_add - Add item to list

• mealie_shopping_items_add_bulk - Add multiple items at once

• mealie_shopping_items_check - Mark item checked/unchecked

• mealie_shopping_items_delete - Remove item from list

• mealie_shopping_add_recipe - Add recipe ingredients to list

• mealie_shopping_generate_from_mealplan - Generate shopping list from meal plan

• mealie_shopping_clear_checked - Clear all checked items

Resources

• recipes://list - Browse all recipes

• recipes://{slug} - View specific recipe

• mealplans://current - Current week's meal plan

• mealplans://today - Today's meals

• mealplans://{date} - Specific date's meals

• shopping://lists - All shopping lists

• shopping://{list_id} - Specific shopping list

Prerequisites

• Docker (or Podman)

• A running Mealie instance

• Mealie API token

Quick Start

1. Get the Docker Image

Option A: Pull from GitHub Container Registry (recommended)

Option B: Build from source

2. Get Your API Token

1. Log into your Mealie instance

2. Go to User Settings (click your name in sidebar)

3. Navigate to API Tokens

4. Create a new token (e.g., "MCP Server")

5. Copy the token immediately (it won't be shown again)

3. Configure Claude Code

Add to .mcp.json in your project root:

Then add mealie to your ~/.claude/settings.json:

4. Test the Connection

Restart Claude Code and try:

Development

Local Development (without Docker)

Project Structure

Security

• Never commit API tokens - Use environment variables

• The API token has full access to your Mealie account

• Consider creating a dedicated Mealie user for the MCP server

Requirements

• Python 3.12+

• Mealie v1.0+ (tested with v3.6.1)

License

MIT

Contributing

Contributions welcome! Please open an issue or PR.

Related

• Mealie - Self-hosted recipe manager

• Model Context Protocol - MCP specification

• FastMCP - Python MCP framework