mealie-mcp-server
3.3
If you are the rightful owner of mealie-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
The Mealie MCP Server allows AI assistants to interact with a Mealie recipe database using the MCP protocol.
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
-
Clone the repository and navigate to the project directory
-
Install dependencies using uv:
uv sync
- Copy the provided template file:
cp .env.template .env
- Edit the
.envfile with your Mealie instance details:
MEALIE_BASE_URL=https://your-mealie-instance.com
MEALIE_API_KEY=your-mealie-api-key
- Run MCP inspector
uv run mcp dev src/server.py
License
This project is licensed under the MIT License - see the file for details.
