Mealie Mcp Server
What is Mealie Mcp Server
mealie-mcp-server is an MCP server that allows AI assistants to interact with the Mealie recipe database through MCP clients like Claude Desktop.
Use cases
Use cases include integrating AI assistants for recipe recommendations, managing personal recipe databases, and enhancing cooking experiences through interactive AI tools.
How to use
To use mealie-mcp-server, you can either install it directly using the ‘fastmcp’ command or configure it manually in your ‘claude_desktop_config.json’ file with the necessary environment variables.
Key features
Key features include easy integration with Mealie APIs, support for multiple configuration options, and compatibility with AI assistants like Claude Desktop.
Where to use
mealie-mcp-server can be used in the culinary and recipe management fields, particularly for applications involving AI-driven recipe suggestions and management.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Mealie Mcp Server
mealie-mcp-server is an MCP server that allows AI assistants to interact with the Mealie recipe database through MCP clients like Claude Desktop.
Use cases
Use cases include integrating AI assistants for recipe recommendations, managing personal recipe databases, and enhancing cooking experiences through interactive AI tools.
How to use
To use mealie-mcp-server, you can either install it directly using the ‘fastmcp’ command or configure it manually in your ‘claude_desktop_config.json’ file with the necessary environment variables.
Key features
Key features include easy integration with Mealie APIs, support for multiple configuration options, and compatibility with AI assistants like Claude Desktop.
Where to use
mealie-mcp-server can be used in the culinary and recipe management fields, particularly for applications involving AI-driven recipe suggestions and management.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
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 LICENSE file for details.
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
