Integrations

Claude and ChatGPT via MCP

Connect an AI assistant securely to a selected Mise kitchen.

Mise includes a Model Context Protocol server. A compatible assistant can search recipes, plan meals, and manage pantry and shopping data in the workspace you approve.

The endpoint is /mcp on the same origin as Mise:

https://mise.example.com/mcp

There is no additional MCP service to deploy.

Requirements

  • Mise must be reachable at a public HTTPS URL.
  • WEB_ORIGIN must equal that public origin.
  • The reverse proxy must preserve the Authorization header and avoid buffering MCP responses.

Connect with OAuth

In Claude or ChatGPT, add a custom connector using the MCP URL. The client redirects you to Mise to sign in, select a workspace, and approve read and write access. No token needs to be copied.

After connecting, try:

  • “Send this recipe to Mise.”
  • “What is on the meal plan this week?”
  • “Add the missing ingredients to my shopping list.”
  • “We are out of butter.”

Available tools

ToolScopePurpose
list_householdsreadList available kitchens and the default.
set_default_householdreadChange the default kitchen for the connection.
create_recipewriteSave structured recipe data or full JSON-LD.
search_recipesreadSearch the recipe library.
get_recipereadRead one recipe as Schema.org JSON-LD.
list_recipesreadBrowse recipes newest first.
get_meal_planreadRead planned meals for a date range.
add_meal_to_planwriteSchedule a recipe.
update_planned_mealwriteMove, replace, or resize a planned meal.
remove_meal_from_planwriteDelete a planned meal.
get_shopping_listreadRead shopping items.
add_to_shopping_listwriteAdd items or a recipe's ingredients.
list_pantryreadBrowse pantry, fridge, or freezer inventory.
add_pantry_itemswriteStock or restock inventory.
remove_pantry_itemwriteRemove inventory by ID or name.
search / fetchreadChatGPT-compatible recipe aliases.

Every tool is restricted to a workspace the signed-in person belongs to.

Personal access token

Clients that support a static header can use a token created in Access Tokens:

claude mcp add --transport http mise https://mise.example.com/mcp \
  --header "Authorization: Bearer mise_…"

For MCP Inspector, choose Streamable HTTP, enter the MCP URL, and add the same Authorization: Bearer mise_… header.

OAuth endpoints

Mise acts as both the protected resource and OAuth authorization server:

EndpointPurpose
/.well-known/oauth-protected-resourceAdvertises the authorization server.
/.well-known/oauth-authorization-serverOAuth server metadata.
/oauth/registerDynamic client registration.
/oauth/authorizeSign-in, workspace selection, consent, and PKCE code.
/oauth/tokenExchanges codes and refresh tokens.
/oauth/revokeRevokes a token.

MCP requests are stateless, so multiple Mise replicas do not require session affinity.

On this page