# tandoor-recipe-mcp

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 10 repo stars
- Author: Cliftonz
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Cliftonz/tandoor-recipe-mcp
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/tandoor-recipe-mcp

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `TANDOOR_URL`, `TANDOOR_TOKEN`, `TANDOOR_MCP_TRANSPORT` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
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-mcp
```
Replace <…> with your own values

## When to use it
- 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
- 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

## Similar
- [pp-recipe-goat](https://affpapa.org/en/nevibecode/skills/pp-recipe-goat.md) — skill · 3300 installs
- [recipe-card-creator](https://affpapa.org/en/nevibecode/skills/recipe-card-creator.md) — skill · 183 installs
- [Food-Recipe-MCP](https://affpapa.org/en/nevibecode/mcp/food-recipe-mcp.md) — MCP server · 2189 installs
- [cabinet-ai-knowledge-base](https://affpapa.org/en/nevibecode/skills/cabinet-ai-knowledge-base.md) — skill · 615 installs
- [recipe-label-and-archive-emails](https://affpapa.org/en/nevibecode/skills/recipe-label-and-archive-emails.md) — skill · 31500 installs
- [recipe-schedule-recurring-event](https://affpapa.org/en/nevibecode/skills/recipe-schedule-recurring-event.md) — skill · 31300 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
