Tandoor

Provides programmatic access to Tandoor recipe and meal plan data via MCP for managing recipes, meal plans, and auto-creation of missing data.

javascript

0

GitHub Stars

javascript

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mc-mario-tandoor-mcp": {
      "command": "npx",
      "args": [
        "tandoor-mcp"
      ],
      "env": {
        "TANDOOR_URL": "https://your-tandoor-instance.com",
        "TANDOOR_TOKEN": "your-api-token"
      }
    }
  }
}

This MCP server enables you to manage Tandoor recipes and meal plans through the Model Context Protocol. You can list, retrieve, create, and update recipes; plan meals; and automatically generate missing ingredients, units, and keywords for you.

How to use

Connect your MCP client to the Tandoor MCP Server to access recipe and meal plan functionality. Use your client to browse recipes, view details, create new recipes with ingredients and steps, and update existing ones. You can also view, schedule, and modify meal plans, and you can enable automatic generation of any missing ingredients, units, or keywords to keep your data consistent.

How to install

Prerequisites: Node.js and npm must be installed on your system.

Install the MCP server globally so you can run the command from anywhere.

npm install -g tandoor-mcp

Or run the MCP server without installing globally using npx, which fetches the package on demand.

npx tandoor-mcp

Configuration and usage notes

Before you can connect, obtain an API token from your Tandoor instance: go to Settings → API Tokens → Create new token. You will use this token to authorize MCP requests.

Configure your MCP client with the following example. Replace the placeholder values with your actual URL and token.

{
  "mcpServers": {
    "tandoor": {
      "command": "npx",
      "args": ["tandoor-mcp"],
      "env": {
        "TANDOOR_URL": "https://your-tandoor-instance.com",
        "TANDOOR_TOKEN": "your-api-token"
      }
    }
  }
}

Available tools

list_recipes

Browse recipes with filtering to find specific entries.

get_recipe

Retrieve detailed information for a single recipe.

create_recipe

Add a new recipe, including steps and ingredients.

update_recipe

Modify an existing recipe.

list_meal_plans

View all scheduled or existing meal plans.

get_meal_plan

Get details for a specific meal plan.

create_meal_plan

Schedule a recipe into a meal plan.

update_meal_plan

Update attributes of an existing meal plan.

delete_meal_plan

Remove a meal plan.

auto_meal_plan

Auto-generate meal plans based on keywords.

list_meal_types

List available meal types such as breakfast, lunch, etc.