Connect Claude, ChatGPT or another assistant to Dinner Planner, and ask it in your own
words. It reads your menu, keeps your shopping list and plans next week, inside your
kitchen's rules.
Assistant tools are included with your household’s Dinner Planner Pro subscription.
You: What's for dinner tonight?
Assistant:
Chicken tikka masala with rice. It takes 35 minutes and serves the four of you.
Opens in Dinner Planner
You: Add oat milk and coffee to the shopping list.
Assistant: Done. Both are on your list, which has 28
things now.
You: Plan three dinners for next week. Quick ones.
Assistant:
Here's "Quick favourites": pesto fusilli, a salmon poke bowl and a tofu stir-fry. All without
peanuts, as your kitchen says.
What you can ask
Tonight
"What's for dinner?"
"Read me the recipe, one step at a time."
"We've eaten. What's tomorrow?"
Shopping
"What do we still need to buy?"
"Add oat milk and coffee to the list."
"I got the chicken. Tick it off."
Planning
"Plan five dinners for next week."
"Swap the tacos for something quicker."
"Make the lasagne vegetarian."
Every answer links back: a recipe, cooking mode, the menu or the shopping list opens in the
app at the right place. Making new menus and recipes, swapping dinners and changing recipes
use the same allowance as in the app. With Pro they don't run out.
See what's free
Connect in three steps.
Use the same Dinner Planner account as in the app. Your household needs active Pro access
to use assistant tools. No password is ever given to the assistant.
Claude
In Claude, open Settings, then Connectors, and choose Add custom connector.
Name it Dinner Planner and paste the address below.
Choose Connect, sign in to Dinner Planner and choose Allow.
ChatGPT
In ChatGPT, open Plugins, choose the plus button, then add a custom server.
Name it Dinner Planner and paste the address below.
Choose sign-in with OAuth, sign in to Dinner Planner and choose Allow.
Any other assistant
Find where your assistant adds a connector, an app or a remote server.
Paste the address below.
Sign in to Dinner Planner when it asks, and choose Allow.
The address
https://dinnerplanner.ai/mcp
The menus are named as each assistant had them when this was written, and they move. If
yours looks different, look for "connectors" and paste the same address.
What it can see, and what it can't.
An assistant gets the household you pick when you connect it, and nothing else of yours.
It can see
Your menus, recipes and shopping lists, and your kitchen's rules: how many you are,
allergies, diet, dislikes, equipment and the country you shop in.
It cannot see
Your email address or password, your subscription or payments, who else is in the
household, or any other household.
You choose what it may do
Reading is always included. Changing the shopping list and menus, and making new menus and
recipes, are two separate ticks when you connect.
Your rules still apply
Allergies and diet are checked by Dinner Planner for everything an assistant asks for,
exactly as in the app. An assistant cannot switch them off.
Everything shows up in the app
Each thing an assistant does is listed under Profile, AI assistants, Activity, for
everyone in the household.
You can remove it at once
Connected assistants are listed in the app with when they were last used. Remove one and
its next request is refused.
For developers
The dinner planner your assistant can use.
Dinner Planner is a remote MCP server with OAuth. Any client that speaks the Model Context
Protocol over HTTP can use it.
Endpoint
https://dinnerplanner.ai/mcp, streamable HTTP, stateless. POST only.
Authorization
OAuth 2.1 with PKCE (S256) and state. Metadata at
https://dinnerplanner.ai/.well-known/oauth-authorization-server and
/.well-known/oauth-protected-resource.
Clients
Client ID metadata documents and dynamic client registration. Redirect addresses are
matched exactly: https, or http on a loopback host.
Tokens
Access tokens last one hour. Refresh tokens rotate and last 90 days from their last use.
Limits
Requests are limited per connection and per household, and answer 429 with
Retry-After. Making menus and recipes uses the household's own allowance.
Results
A sentence to relay, then the same facts as structured content. Every menu, recipe and
list carries its id and a link that opens it in the app.
Scopes
Scope
What it allows
dinner:read
See what's for dinner, your menus, recipes, shopping lists and kitchen rules
dinner:write
Tick off and add shopping items, mark dinners as cooked, put your recipes on a menu
dinner:generate
Plan menus and create or change recipes with AI, using your household's allowance
The 18 tools
Tool
What it does
Kind
Scopes
whats_for_dinner
The household's next dinner on this week's menu, with links that open it in the Dinner Planner app.
Reads
dinner:read
get_menu
One menu with all its dinners, which are cooked, its week and its shopping list.
Reads
dinner:read
list_menus
The household's menus, most recently changed first, with how many dinners each has, how many are cooked, and which is this week's (the one it cooks from) and next week's.
Reads
dinner:read
get_recipe
One recipe in full: ingredients with amounts, numbered steps, timers and tips.
Reads
dinner:read
search_recipes
Searches the household's own recipe library by words in the title or description, newest first.
Reads
dinner:read
get_shopping_list
What is left to buy, in the order of a walk through the shop.
Reads
dinner:read
get_kitchen
Who the household cooks for and its rules: allergies and diet (hard rules that everything planned here follows), dislikes, effort, equipment and the country it shops in.
Reads
dinner:read
get_recipe_photo
Returns the saved photo of a household recipe, its plate circle and an image resource link when ready.
Reads
dinner:read
prepare_shopping_order
Reads the items still needed and the household dietary rules for a grocery handoff to another store integration the person uses.
Reads
dinner:read
add_shopping_items
Adds things to buy to a shopping list: this week's list (the list of this week's menu) without list_id, or next week's with week; a first list is started when the household has none.
Changes
dinner:readdinner:write
check_shopping_items
Marks things on a shopping list as bought (or, with checked false, as still to buy): this week's list without list_id, or next week's with week.
Changes
dinner:readdinner:write
update_shopping_item
Updates one item from get_shopping_list by item_id: mark it needed, checked, or have (already at home); edit its note or aisle; rename or change the amount of a manual item.
Changes
dinner:readdinner:write
mark_dinner_cooked
Marks a dinner on a menu as cooked, so the menu moves on to the next one.
Changes
dinner:readdinner:write
plan_menu
Plans a new menu of dinners for the household with AI, following its allergies, diet and size.
Makes with AI
dinner:readdinner:generate
add_dinner
Adds one dinner to the end of a menu (this week's without menu_id; a household with no menu this week gets one).
Makes with AI
dinner:readdinner:write dinner:generate when a new dinner is made up (no recipe_id)
swap_dinner
Replaces one dinner on a menu with another, in the same place.
Makes with AI
dinner:readdinner:write dinner:generate when a new dinner is made up (no recipe_id)
create_recipe
Writes a new recipe with AI for the household's size, following its allergies and diet, and saves it in the library.
Makes with AI
dinner:readdinner:generate
change_recipe
Changes a recipe in two calls, so nothing is saved by accident.
Makes with AI
dinner:readdinner:write dinner:generate for the first call, which drafts the change
It starts with a menu.
Get the app, make your first menu, then connect your assistant.
