Save and adapt recipes, plan household dinners for review, and manage shared grocery lists.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Enable the recipe, grocery and reviewed meal-planning tool catalog. OAuth permissions and personal subscription access are required for household operations.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Add a grocery item to the connected household's private grocery list in Brie.
A unique ID for this user-requested action. Reuse this exact ID and payload after a timeout; use a new ID only for a new action.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Add a grocery item to the connected household's private grocery list in Brie.
| Argument | Type | Description |
|---|---|---|
| item* | string | |
| operation_id* | string | A unique ID for this user-requested action. Reuse this exact ID and payload after a timeout; use a new ID only for a new action. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"operation_id",
"item"
],
"properties": {
"item": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"operation_id": {
"type": "string",
"maxLength": 128,
"minLength": 16,
"description": "A unique ID for this user-requested action. Reuse this exact ID and payload after a timeout; use a new ID only for a new action."
}
},
"additionalProperties": false
}Save a complete new recipe only after the user asks to save it. Supply ingredients, servings, times, and ordered directions; keep unknown, qualitative, or ranged quantities null and preserve their wording in raw_text. Never invent source facts or macros. Returns the saved recipe immediately; external services prepare its image and optional estimated nutrition in the background. Use get_recipe to check readiness.
| Argument | Type | Description |
|---|---|---|
| tags | array | |
| title* | string | |
| cuisine | string | |
| servings* | integer | |
| difficulty* | string | |
| meal_types* | array | |
| description | string | |
| ingredients* | array | |
| cook_minutes* | integer | |
| instructions* | array | |
| operation_id* | string | A unique ID for this user-requested action. Reuse this exact ID and payload after a timeout; use a new ID only for a new action. |
| prep_minutes* | integer |
Read the connected household's grocery list. shop-now covers Upcoming; all-planned includes future planned meals. Returns paginated results; follow next_offset until null to retrieve the complete list.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| scope | string | |
| offset | integer | |
| include_checked | boolean |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 100,
"minimum": 1
},
"scope": {
"enum": [
"shop-now",
"all-planned"
],
"type": "string",
"default": "shop-now"
},
"offset": {
"type": "integer",
"default": 0,
"maximum": 10000,
"minimum": 0
},
"include_checked": {
"type": "boolean",
"default": false
}
},
"additionalProperties": false
}Check an import job by ID. Report its status; if it needs more information, direct the user to the import in Brie. Poll this job rather than importing again.
| Argument | Type | Description |
|---|---|---|
| job_id* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
}Read a recipe from the connected household, including ingredients, directions, and source. Supply version_id for a specific saved version or omit it for the current recipe. Display display_text as the current ingredient wording; raw_text is original source wording. Keep version_id, version_revision, and ingredient_id values for update_recipe.
| Argument | Type | Description |
|---|---|---|
| recipe_id* | string | |
| version_id | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"recipe_id"
],
"properties": {
"recipe_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"version_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
},
"additionalProperties": false
}Import a public recipe URL or supplied recipe text when the user asks to save it, preserving its creator and source. Returns a background job; check it with get_import_status. Use create_recipe for a new recipe developed in the conversation.
| Argument | Type | Description |
|---|---|---|
| url | string | |
| text | string | |
| title | string | |
| creator | string | |
| servings | integer | |
| publication | string | |
| operation_id* | string | A unique ID for this user-requested action. Reuse this exact ID and payload after a timeout; use a new ID only for a new action. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"operation_id"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"text": {
"type": "string",
"maxLength": 60000,
"minLength": 1
},
"title": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"creator": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"servings": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"publication": {
"type": "string",
"maxLength": 300,
"minLength": 1
},
"operation_id": {
"type": "string",
"maxLength": 128,
"minLength": 16,
"description": "A unique ID for this user-requested action. Reuse this exact ID and payload after a timeout; use a new ID only for a new action."
}
},
"additionalProperties": false
}Search the connected household's saved recipes. Returns matches with sources and saved version IDs. Use get_recipe for ingredients and directions.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| query* | string |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 20,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 300,
"minLength": 1
}
},
"additionalProperties": false
}Update an existing recipe as a named version only after the user reviews the changes and asks to save them. First use get_recipe; copy version_id and version_revision into the expected fields. Submit the complete revised recipe: omitted ingredients and directions are removed. Map existing ingredient_id values to source_ingredient_id; use null for new ingredients. Keep current display_text and preserve qualitative or ranged quantities as null. Retains the recipe ID, image, source, earlier versions, and versions used by planned meals. External services may prepare optional nutrition and search updates. On version_conflict, read and review again before a new operation; never silently rebase or create a duplicate.
| Argument | Type | Description |
|---|---|---|
| title* | string | |
| servings* | integer | |
| recipe_id* | string | |
| difficulty* | string | |
| description* | string | |
| ingredients* | array | |
| cook_minutes* |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"operation_id",
"title",
"servings",
"prep_minutes",
"cook_minutes",
"difficulty",
"meal_types",
"ingredients",
"instructions"
],
"properties": {
"tags": {
"type": "array",
"items": {
"type": "string",
"maxLength": 50,
"minLength": 1
},
"default": [],
"maxItems": 20
},
"title": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"cuisine": {
"type": "string",
"default": "Home cooking",
"maxLength": 100,
"minLength": 1
},
"servings": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"difficulty": {
"enum": [
"easy",
"moderate",
"challenging"
],
"type": "string"
},
"meal_types": {
"type": "array",
"items": {
"enum": [
"breakfast",
"lunch",
"dinner"
],
"type": "string"
},
"maxItems": 3,
"minItems": 1
},
"description": {
"type": "string",
"default": "",
"maxLength": 2000
},
"ingredients": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"raw_text",
"amount",
"unit",
"section"
],
"properties": {
"name": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"unit": {
"anyOf": [
{
"type": "string",
"maxLength": 80,
"minLength": 1
},
{
"type": "null"
}
]
},
"amount": {
"anyOf": [
{
"type": "number",
"maximum": 100000,
"exclusiveMinimum": 0
},
{
"type": "null"
}
]
},
"section": {
"enum": [
"Produce",
"Meat",
"Dairy",
"Pantry",
"Frozen",
"Household"
],
"type": "string"
},
"optional": {
"type": "boolean",
"default": false
},
"raw_text": {
"type": "string",
"maxLength": 600,
"minLength": 1
},
"quantity_text": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 100,
"minItems": 1
},
"cook_minutes": {
"type": "integer",
"maximum": 10080,
"minimum": 0
},
"instructions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 3000,
"minLength": 1
},
"maxItems": 100,
"minItems": 1
},
"operation_id": {
"type": "string",
"maxLength": 128,
"minLength": 16,
"description": "A unique ID for this user-requested action. Reuse this exact ID and payload after a timeout; use a new ID only for a new action."
},
"prep_minutes": {
"type": "integer",
"maximum": 1440,
"minimum": 0
}
},
"additionalProperties": false
}| integer |
| instructions* | array |
| operation_id* | string | A unique ID for this user-requested action. Reuse this exact ID and payload after a timeout; use a new ID only for a new action. |
| prep_minutes* | integer |
| version_label | string | A short descriptive name, such as Less sweet. Use the version label requested by the user, if any. |
| change_summary* | string |
| expected_revision* | string | Copy version_revision from that same get_recipe result. On conflict, reload and review with the user; never silently overwrite. |
| expected_version_id* | string | The current version_id returned by get_recipe before discussing this edit. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"operation_id",
"recipe_id",
"expected_version_id",
"expected_revision",
"change_summary",
"title",
"description",
"servings",
"prep_minutes",
"cook_minutes",
"difficulty",
"ingredients",
"instructions"
],
"properties": {
"title": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"servings": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"recipe_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"difficulty": {
"enum": [
"easy",
"moderate",
"challenging"
],
"type": "string"
},
"description": {
"type": "string",
"maxLength": 2000
},
"ingredients": {
"type": "array",
"items": {
"type": "object",
"required": [
"source_ingredient_id",
"name",
"display_text",
"amount",
"unit",
"quantity_text",
"group",
"preparation",
"note",
"optional"
],
"properties": {
"name": {
"type": "string",
"maxLength": 180,
"minLength": 1
},
"note": {
"anyOf": [
{
"type": "string",
"maxLength": 300,
"minLength": 1
},
{
"type": "null"
}
]
},
"unit": {
"anyOf": [
{
"type": "string",
"maxLength": 60,
"minLength": 1
},
{
"type": "null"
}
]
},
"group": {
"anyOf": [
{
"type": "string",
"maxLength": 100,
"minLength": 1
},
{
"type": "null"
}
]
},
"amount": {
"anyOf": [
{
"type": "number",
"maximum": 100000,
"minimum": 0
},
{
"type": "null"
}
]
},
"optional": {
"type": "boolean"
},
"preparation": {
"anyOf": [
{
"type": "string",
"maxLength": 180,
"minLength": 1
},
{
"type": "null"
}
]
},
"display_text": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"quantity_text": {
"anyOf": [
{
"type": "string",
"maxLength": 160,
"minLength": 1
},
{
"type": "null"
}
]
},
"source_ingredient_id": {
"anyOf": [
{
"type": "string",
"pattern": "^ingredient_[1-9]\\d*$"
},
{
"type": "null"
}
],
"description": "Copy ingredient_id from the base recipe for retained or changed rows; null only for a newly added ingredient. Omit removed rows."
}
},
"additionalProperties": false
},
"maxItems": 100,
"minItems": 1
},
"cook_minutes": {
"type": "integer",
"maximum": 1440,
"minimum": 0
},
"instructions": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2000,
"minLength": 1
},
"maxItems": 80,
"minItems": 1
},
"operation_id": {
"type": "string",
"maxLength": 128,
"minLength": 16,
"description": "A unique ID for this user-requested action. Reuse this exact ID and payload after a timeout; use a new ID only for a new action."
},
"prep_minutes": {
"type": "integer",
"maximum": 1440,
"minimum": 0
},
"version_label": {
"type": "string",
"default": "Our edited version",
"maxLength": 80,
"minLength": 1,
"description": "A short descriptive name, such as Less sweet. Use the version label requested by the user, if any."
},
"change_summary": {
"type": "string",
"maxLength": 500,
"minLength": 1
},
"expected_revision": {
"type": "string",
"maxLength": 128,
"minLength": 1,
"description": "Copy version_revision from that same get_recipe result. On conflict, reload and review with the user; never silently overwrite."
},
"expected_version_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The current version_id returned by get_recipe before discussing this edit."
}
},
"additionalProperties": false
}