dinnerbord

Connect an AI assistant

Let Claude or another MCP-compatible assistant read your recipes, add new ones, and suggest dinners for the week.

Dinnerbord has an MCP (Model Context Protocol) server. Once connected, an AI assistant such as Claude can work with your household's recipes and weekly plan. You can ask it things like:

  • "Plan dinners for next week using our recipes. No chicken two days in a row."
  • "What's on the plan this week, and which days still need a dinner?"
  • "Add my lasagne recipe and tag it batch cook." (paste or describe the recipe)
  • "Which of our recipes are tagged quick?"
  • "Go through our recipes and tag the ones that take under 30 minutes as quick."

What the assistant can do

  • Read recipes: list the household's recipes, search by name, filter by Tag or protein, and open a recipe to see its ingredients and notes.
  • Add recipes and Tags: create recipes with ingredients, notes, and Tags, and create standalone Tags. Tags are matched regardless of case, so it reuses your household's existing Tags instead of making duplicates.
  • Tag existing recipes: add Tags to or remove Tags from recipes already in your library, several at once. Nothing else on the recipe changes.
  • Read the week: see each day's Locked dinner, the open suggestions, who has +1'd them, and any protein-variety warnings.
  • Suggest dinners: suggest a recipe for one or more days, or withdraw a suggestion.
  • Verify a day (Organizers only): Lock a day's dinner straight away.

Apart from their Tags, the assistant can't edit or delete existing recipes. It also can't change household settings or touch the grocery list.

The assistant acts as you

Everything the assistant does is done as you, in one household:

  • Its suggestions are your suggestions. It follows the same rules as the app: you hold at most one suggestion per day, and a new one replaces your old one.
  • Days still Lock the usual way, once every Member has +1'd the same recipe. The assistant can't Lock a day for the rest of your household unless you're an Organizer and ask it to Verify.
  • Other Members get the usual push notification for each suggestion. If the assistant plans a whole week at once, that's one notification per day.

Connect Claude

Claude signs in to Dinnerbord for you, so there's no token to copy.

  1. In Claude, open Settings → Connectors and choose Add custom connector.
  2. Name it "Dinnerbord" and use the URL https://dinnerbord.com/mcp.
  3. Click Connect. A Dinnerbord page opens. Log in if you need to.
  4. If you're in more than one household, pick the one Claude should work in, then click Allow.

Once added, the connector works in Claude on the web, in Claude Desktop, and in the mobile apps.

Connect Claude Code

Run this in a terminal:

claude mcp add --transport http dinnerbord https://dinnerbord.com/mcp

Then start Claude Code, type /mcp, pick dinnerbord and choose Authenticate. Your browser opens the same Dinnerbord sign-in page.

Other assistants

Any MCP client that supports the Streamable HTTP transport can connect to https://dinnerbord.com/mcp. Clients that support MCP's OAuth sign-in find everything they need automatically.

For clients that don't, use a personal API token instead.

Create an API token

  1. Open Profile from the sidebar.
  2. Under AI assistants → API tokens, give the token a name you'll recognise later (for example "My script") and click Create token.
  3. Copy the token now. It starts with dnb_ and is only shown once.

A token belongs to the household you were in when you created it. If you're in more than one household, create a separate token in each.

Treat the token like a password. Anyone who has it can read your recipes and make suggestions as you.

Send it with every request as a header:

  • URL: https://dinnerbord.com/mcp
  • Header: Authorization: Bearer dnb_your_token

For example, Claude Code can also use a token instead of signing in:

claude mcp add --transport http dinnerbord https://dinnerbord.com/mcp --header "Authorization: Bearer dnb_your_token"

Disconnecting

Go to Profile → AI assistants. Apps you signed in to are listed under Connected apps; click Disconnect next to one to cut off its access. API tokens are listed below them; click Revoke next to a token. Either way the assistant loses access immediately. Both lists show when each was last used, which helps you find ones you no longer need.

Connections and tokens also stop working if you leave the household, or if its subscription or trial ends.