mealie-mcp-server

mealie-mcp-server

2
databasesdeveloper_tools

Mealie MCP Server allows AI assistants to interact with a Mealie recipe database via an MCP client like Claude Desktop. It requires Python 3.12+, a running Mealie instance with an API key, and the uv package manager.

Mealie MCP Server

This project enables AI assistants to interact with your Mealie recipe database through MCP client such as Claude Desktop.

Prerequisites

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

Usage with Claude Desktop

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

Development

  1. Clone the repository and navigate to the project directory

  2. Install dependencies using uv:

uv sync
  1. Copy the provided template file:
cp .env.template .env
  1. Edit the .env file with your Mealie instance details:
MEALIE_BASE_URL=https://your-mealie-instance.com
MEALIE_API_KEY=your-mealie-api-key
  1. Run MCP inspector
uv run mcp dev src/server.py

License

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