Recipe MCP Server

Only Recipes runs a remote Model Context Protocol server. Any MCP client that supports Streamable HTTP and OAuth can search recipes, import recipe links and, after you sign in, manage your recipe box, grocery list and meal plan.

By the Only Recipes Team. Updated .

Endpoint

https://onlyrecipes.app/mcp
  • Transport: Streamable HTTP (stateless, JSON responses)
  • Auth: OAuth 2.1 with PKCE and dynamic client registration. Discovery at /.well-known/oauth-protected-resource/mcp. Anonymous requests see the public tools only.
  • Scopes: recipes:read and recipes:write

Claude (claude.ai and Claude Desktop)

Settings, Connectors, Add custom connector, then paste the URL above. Full steps on the Claude page.

Claude Code

claude mcp add --transport http only-recipes https://onlyrecipes.app/mcp

Then run /mcp in Claude Code and choose Authenticate to sign in.

Cursor

Add this to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):

{
  "mcpServers": {
    "only-recipes": {
      "url": "https://onlyrecipes.app/mcp"
    }
  }
}

VS Code

Add this to .vscode/mcp.json, or run MCP: Add Server from the command palette and choose HTTP:

{
  "servers": {
    "only-recipes": {
      "type": "http",
      "url": "https://onlyrecipes.app/mcp"
    }
  }
}

ChatGPT

ChatGPT uses the same server. See the ChatGPT setup.

Tools

22 tools, listed from the server itself. “Sign-in” tools appear after you connect your account.

ToolWhat it doesAccessHints
import_recipe
Import recipe
Use this when the user pastes a recipe link (any recipe site, Instagram, TikTok, YouTube, Pinterest or Facebook) and wants the recipe itself.Publicwrites, open world
search_recipes
Search recipes
Use this when the user wants ideas or recipes to cook, by dish, ingredient, cuisine, diet, time or rating, or just wants to browse.Publicread-only
find_recipe
Find a recipe by link
Use this when the user shares a recipe link and you only need to know whether Only Recipes already has it.Publicread-only
get_filters
Get search filters
Use this when you need valid tag slugs for search_recipes, for example to filter by cuisine, course, diet or occasion.Publicread-only
get_recipe
Get a recipe
Use this when the user wants to see or cook one specific recipe: its ingredients, steps, times and photo.Publicread-only
save_recipe
Save a recipe
Use this when the user asks to save or keep a recipe.Sign-inwrites
create_recipe
Create a recipe
Use this when the user gives you a recipe as text (typed, pasted, or one of their own) and wants it in Only Recipes.Sign-inwrites
list_kitchens
List kitchens
Use this when the user mentions a shared or specific kitchen, or another tool says the kitchen is ambiguous or not found.Sign-inread-only
list_my_recipes
List my recipes
Use this when the user wants to see their own recipes: ones they saved or added to their kitchen.Sign-inread-only
unsave_recipe
Remove a saved recipe
Use this only when the user explicitly asks to remove a recipe from their saved recipes.Sign-inwrites, destructive
update_recipe
Edit a recipe
Use this when the user asks to change a recipe in their kitchen: title, description, ingredients, steps, notes, servings or times.Sign-inwrites, destructive
list_collections
List collections
Use this when the user asks about their recipe collections.Sign-inread-only
create_collection
Create a collection
Use this when the user asks for a new recipe collection (a named group like 'Weeknight dinners').Sign-inwrites
add_to_collection
Add to a collection
Use this when the user asks to put one or more of their kitchen's recipes into a collection.Sign-inwrites
remove_from_collection
Remove from a collection
Use this only when the user explicitly asks to take recipes out of a collection.Sign-inwrites, destructive
get_grocery_list
Get grocery list
Use this when the user wants to see what is on their grocery or shopping list.Sign-inread-only
add_to_grocery_list
Add to grocery list
Use this when the user wants to shop for something or put items on their grocery list: loose items, a recipe's ingredients, or everything on their meal plan between two dates.Sign-inwrites
check_off_items
Check off grocery items
Use this when the user has bought items, or wants to uncheck them.Sign-inwrites
remove_from_grocery_list
Remove from grocery list
Use this only when the user asks to remove items from their grocery list, or to clear the items they have checked off.Sign-inwrites, destructive
get_meal_plan
Get meal plan
Use this when the user asks what's on their meal plan or what they're cooking on certain days.Sign-inread-only
plan_meal
Plan a meal
Use this when the user wants to put recipes or a dish on their meal plan for a day and meal (Breakfast, Lunch, Dinner...), including casual requests like 'we are having the chili on Sunday'.Sign-inwrites, destructive
remove_from_meal_plan
Remove from meal plan
Use this only when the user asks to take something off their meal plan.Sign-inwrites, destructive

Privacy: private by default

  • Without signing in, an assistant can only search public recipes and import recipe links. Nothing in your account is visible to it.
  • When you connect, you sign in to Only Recipes yourself and approve read access, write access or both. The assistant never sees your password.
  • Recipes you save from a chat are private to your kitchen.
  • Disconnect any assistant at any time from Connected apps. Access ends immediately.

Frequently Asked Questions

Connect your recipe box

Create an Only Recipes account, connect it to your assistant, and every recipe you save shows up on the web, iPhone and Android.