Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Tandoor MCP ServerFind a recipe for lasagna and add the ingredients to my shopping list"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Tandoor MCP Server
A FastMCP server for interacting with Tandoor Recipe Manager via the Model Context Protocol.
Features
Recipe Management: Search, view, create, and import recipes from URLs
Cooking History: Track what you've cooked with ratings and notes
Recipe Suggestions: Get recipe ideas based on pantry inventory
Meal Planning: Plan meals with bulk scheduling support
Shopping Lists: Manage shopping with bulk add/remove/check operations
Pantry Tracking: Track on-hand ingredients for smarter suggestions
Lookups: Search keywords, foods, and units
Tools (4 Consolidated Tools)
tandoor_recipes
Operation | Description | Bulk Support |
| Search recipes by name, keywords, foods, or rating | - |
| Get full recipe with ingredients and instructions | - |
| Create a new recipe | - |
| Import recipe from URL |
|
| Get cooking history with date filtering | - |
| Log a cooked recipe with rating/notes |
|
| Get recipe suggestions based on pantry | - |
tandoor_meal_plan
Operation | Description | Bulk Support |
| List available meal types | - |
| Get meal plan entries with date filtering | - |
| Add recipe to meal plan |
|
| Create a new meal type | - |
| Delete a meal plan entry |
|
tandoor_shopping_list
Operation | Description | Bulk Support |
| Get shopping list items | - |
| Add item to shopping list |
|
| Update a shopping list item | - |
| Remove item from shopping list |
|
| Check/uncheck items |
|
| Clear checked items and sync to pantry | - |
tandoor_lookup
Type | Description | Bulk Support |
| Search recipe keywords/tags | - |
| Search foods/ingredients | - |
| Search measurement units | - |
| View/update pantry inventory |
|
Bulk Operations Examples
Plan a week of meals
tandoor_meal_plan(
operation="create",
meals=[
{"recipe": "Pasta Carbonara", "date": "2025-01-27", "meal_type": 3, "servings": 4},
{"recipe": "Chicken Curry", "date": "2025-01-28", "meal_type": 3, "servings": 4},
{"recipe": "Beef Tacos", "date": "2025-01-29", "meal_type": 3, "servings": 4},
]
)Add multiple items to shopping list
tandoor_shopping_list(
operation="add",
add_items=[
{"food": "Milk", "amount": 1, "unit": "gallon"},
{"food": "Eggs", "amount": 12},
{"food": "Bread", "amount": 1, "unit": "loaf"},
]
)Update pantry inventory
tandoor_lookup(
type="pantry",
action="update",
pantry_items=[
{"food_name": "salt", "on_hand": True},
{"food_name": "pepper", "on_hand": True},
{"food_id": 123, "on_hand": False},
]
)Log multiple cooked recipes
tandoor_recipes(
operation="log",
logs=[
{"recipe_id": "45", "servings": 4, "rating": 5, "comment": "Perfect!"},
{"recipe_id": "32", "servings": 2, "rating": 4},
]
)Configuration
Set the following environment variables:
Variable | Description |
| Tandoor instance URL (default: |
| Public URL for recipe links (optional) |
| API token from Tandoor settings |
Running with Docker
services:
mcp_server:
build: .
environment:
- TANDOOR_URL=http://your-tandoor-instance
- TANDOOR_PUBLIC_URL=https://recipes.example.com
- TANDOOR_API_TOKEN=your_token_here
ports:
- "8089:8000"Running Locally
pip install -r requirements.txt
export TANDOOR_URL=http://localhost:8081
export TANDOOR_API_TOKEN=your_token_here
python server.pyMCP Client Configuration
{
"mcpServers": {
"tandoor": {
"url": "http://localhost:8089/mcp/"
}
}
}License
MIT