Mealie MCP Server

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

✨ Features

🍽️ Recipe Management

• CRUD Operations: Create, read, update, patch, duplicate, and delete recipes
• Advanced Search: Filter by text, categories, tags, and tools with AND/OR logic
• Image Management: Upload images or scrape from URLs
• Asset Uploads: Attach documents and files to recipes
• Metadata Tracking: Mark recipes as made, track last made dates

🛒 Shopping Lists

• List Management: Create, update, and delete shopping lists
• Item Operations: Add, update, check off, and remove items
• Bulk Operations: Create, update, or delete multiple items at once
• Recipe Integration: Automatically add recipe ingredients to shopping lists

🏷️ Organization

• Categories: Organize recipes with categories (Breakfast, Dinner, etc.)
• Tags: Tag recipes for easy filtering (Quick, Healthy, Family Favorite)
• Advanced Filtering: Search and filter with full pagination support
• Empty Detection: Find unused categories and tags

📅 Meal Planning

• Meal Plans: View and manage meal plans
• Bulk Creation: Add multiple meals at once
• Today's Menu: Quick access to today's planned meals

🚀 Quick Start

Prerequisites

• Python 3.12+
• Running Mealie instance with API key
• Package manager uv

Installation

Option 1: Using fastmcp (Recommended)

Install the server directly with the fastmcp command:

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

Option 2: Manual Configuration

Add the server to your claude_desktop_config.json:

{
  "mcpServers": {
    "mealie-mcp-server": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/repo/src",
        "run",
        "server.py"
      ],
      "env": {
        "MEALIE_BASE_URL": "https://your-mealie-instance.com",
        "MEALIE_API_KEY": "your-mealie-api-key"
      }
    }
  }
}

Restart Claude Desktop to load the server.

📖 Usage Examples

Recipe Operations

"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"

Shopping Lists

"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"

Organization

"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"

Advanced Filtering

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

🎯 Available Tools

Recipe Tools (13 operations)

• 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
• 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

Shopping List Tools (

... View full README on GitHub