tandoor-recipe-mcp — Claude Code MCP server setup guide
MCP server for Claude Code and Codex that links your assistant to a self-hosted Tandoor Recipes server. Plans weekly meals, imports URLs, and syncs grocery lists.
MIT ★ 10 updated 2026-11-16
claude mcp add --env TANDOOR_URL=<TANDOOR_URL> --env TANDOOR_TOKEN=<TANDOOR_TOKEN> --env TANDOOR_MCP_TRANSPORT=<TANDOOR_MCP_TRANSPORT> --transport stdio tandoor-recipe-mcp -- npx -y @cliftonz/tandoor-recipes-mcpWhat tandoor-recipe-mcp does
The server connects LLM clients to a personal Tandoor instance, handling meal calendars, pantry inventories, nutrition records, and shopping checklists. It exposes 306 typed operations covering the Tandoor 2.6 API, presenting 46 tools by default to save context budget.
It features baked-in prompts like plan_week, direct read endpoints, and a three-step web importer relying on Schema.org metadata. Whenever payload sizes top 5KB, a jq stashing mechanism lets the agent query specific fields instead of loading raw blobs.
Executing via Node demands Node 24 or newer. The setup halts immediately without valid TANDOOR_URL and TANDOOR_TOKEN values supplied in the environment.
What it helps with
- generate a full weekly meal schedule from saved recipes
- assemble a grocery checklist matching scheduled meals
- scrape recipes from external webpages via Schema.org
- check on-hand pantry items before cooking
Example prompts for the agent
- Plan dinners for the upcoming week and update the grocery list
- Import a new dish from this URL directly into my Tandoor catalog
- List ingredients currently available in my pantry resource
How to install tandoor-recipe-mcp
Platform CLI
claude mcp add --env TANDOOR_URL=<TANDOOR_URL> --env TANDOOR_TOKEN=<TANDOOR_TOKEN> --env TANDOOR_MCP_TRANSPORT=<TANDOOR_MCP_TRANSPORT> --transport stdio tandoor-recipe-mcp -- npx -y @cliftonz/tandoor-recipes-mcpReplace <…> with your own values
Platform CLI
codex mcp add tandoor-recipe-mcp --env TANDOOR_URL=<TANDOOR_URL> --env TANDOOR_TOKEN=<TANDOOR_TOKEN> --env TANDOOR_MCP_TRANSPORT=<TANDOOR_MCP_TRANSPORT> -- npx -y @cliftonz/tandoor-recipes-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"tandoor-recipe-mcp": {
"command": "npx",
"args": [
"-y",
"@cliftonz/tandoor-recipes-mcp"
],
"env": {
"TANDOOR_URL": "<TANDOOR_URL>",
"TANDOOR_TOKEN": "<TANDOOR_TOKEN>",
"TANDOOR_MCP_TRANSPORT": "<TANDOOR_MCP_TRANSPORT>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"tandoor-recipe-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cliftonz/tandoor-recipes-mcp"
],
"env": {
"TANDOOR_URL": "<TANDOOR_URL>",
"TANDOOR_TOKEN": "<TANDOOR_TOKEN>",
"TANDOOR_MCP_TRANSPORT": "<TANDOOR_MCP_TRANSPORT>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e TANDOOR_URL=<TANDOOR_URL> -e TANDOOR_TOKEN=<TANDOOR_TOKEN> -e TANDOOR_MCP_TRANSPORT=<TANDOOR_MCP_TRANSPORT> tandoor-recipe-mcp npx -y @cliftonz/tandoor-recipes-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about tandoor-recipe-mcp
How to install tandoor-recipe-mcp in Claude Code?
Run claude mcp add tandoor-recipe-mcp -e TANDOOR_URL=<TANDOOR_URL> -e TANDOOR_TOKEN=<TANDOOR_TOKEN> -- npx -y @cliftonz/tandoor-recipes-mcp with your actual instance URL and API secret.
What does tandoor-recipe-mcp do?
It gives coding agents programmatic control over self-hosted Tandoor Recipes setups to search meals, parse links, log cooks, and organize grocery runs.
What is required to run tandoor-recipe-mcp?
You need Node 24 or newer, a reachable Tandoor deployment, its URL passed via TANDOOR_URL, and an authorization key provided via TANDOOR_TOKEN.