Tandoor MCP Server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
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
Related MCP server: Nextcloud Cookbook MCP Server
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
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Save, import and edit recipes as interactive cards in ChatGPT and Claude, synced to your iPhone.
Household-aware cooking brain: pantry, meal suggestions, dietary safety, recipes, shopping lists.
Search structured recipes, scale servings, match pantry ingredients, and build shopping lists.
Recipe search, ingredient matching, nutrition filters and a private cookbook for any AI agent.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables interaction with Tandoor recipe management system to create, manage, and search recipes, as well as create and auto-generate meal plans with automatic ingredient and keyword creation.1134 npm3MIT
- AlicenseNot gradedqualityDmaintenanceIntegrates with the Nextcloud Cookbook app API to enable AI assistants to manage recipes, categories, and keywords. It supports listing, searching, creating, and importing recipes from URLs via a standardized Model Context Protocol interface.MIT
- FlicenseBqualityDmaintenanceMCP server for managing Tandoor recipes, meal plans, and shopping lists. Enables creation, retrieval, and management of recipes, meal plans, and shopping list items via natural language.1319-
- AlicenseNot gradedqualityCmaintenanceEnables natural language interaction with Home Assistant for managing entities, automations, services, and dashboards via the Model Context Protocol.154 npmMIT