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:readandrecipes: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/mcpThen 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.
| Tool | What it does | Access | Hints |
|---|---|---|---|
import_recipeImport recipe | Use this when the user pastes a recipe link (any recipe site, Instagram, TikTok, YouTube, Pinterest or Facebook) and wants the recipe itself. | Public | writes, open world |
search_recipesSearch 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. | Public | read-only |
find_recipeFind 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. | Public | read-only |
get_filtersGet search filters | Use this when you need valid tag slugs for search_recipes, for example to filter by cuisine, course, diet or occasion. | Public | read-only |
get_recipeGet a recipe | Use this when the user wants to see or cook one specific recipe: its ingredients, steps, times and photo. | Public | read-only |
save_recipeSave a recipe | Use this when the user asks to save or keep a recipe. | Sign-in | writes |
create_recipeCreate 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-in | writes |
list_kitchensList kitchens | Use this when the user mentions a shared or specific kitchen, or another tool says the kitchen is ambiguous or not found. | Sign-in | read-only |
list_my_recipesList my recipes | Use this when the user wants to see their own recipes: ones they saved or added to their kitchen. | Sign-in | read-only |
unsave_recipeRemove a saved recipe | Use this only when the user explicitly asks to remove a recipe from their saved recipes. | Sign-in | writes, destructive |
update_recipeEdit a recipe | Use this when the user asks to change a recipe in their kitchen: title, description, ingredients, steps, notes, servings or times. | Sign-in | writes, destructive |
list_collectionsList collections | Use this when the user asks about their recipe collections. | Sign-in | read-only |
create_collectionCreate a collection | Use this when the user asks for a new recipe collection (a named group like 'Weeknight dinners'). | Sign-in | writes |
add_to_collectionAdd to a collection | Use this when the user asks to put one or more of their kitchen's recipes into a collection. | Sign-in | writes |
remove_from_collectionRemove from a collection | Use this only when the user explicitly asks to take recipes out of a collection. | Sign-in | writes, destructive |
get_grocery_listGet grocery list | Use this when the user wants to see what is on their grocery or shopping list. | Sign-in | read-only |
add_to_grocery_listAdd 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-in | writes |
check_off_itemsCheck off grocery items | Use this when the user has bought items, or wants to uncheck them. | Sign-in | writes |
remove_from_grocery_listRemove 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-in | writes, destructive |
get_meal_planGet meal plan | Use this when the user asks what's on their meal plan or what they're cooking on certain days. | Sign-in | read-only |
plan_mealPlan 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-in | writes, destructive |
remove_from_meal_planRemove from meal plan | Use this only when the user asks to take something off their meal plan. | Sign-in | writes, 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.