Notion MCP Server

{ "properties": { "discussion_id": { "description": "The ID of an existing discussion thread to add a comment to.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-).", "type": "string" }, "format": { "default": "markdown", "description": "Specify the response format. 'json' returns the original data structure, 'markdown' returns a more readable format. Use 'markdown' when the user only needs to read the page and isn't planning to write or modify it. Use 'json' when the user needs to read the page with the intention of writing to or modifying it.", "enum": [ "json", "markdown" ], "type": "string" }, "parent": { "description": "Parent object that specifies the page to comment on. Must include a page_id if used.", "properties": { "page_id": { "description": "The ID of the page to comment on.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-).", "type": "string" } }, "type": "object" }, "rich_text": { "description": "Array of rich text objects representing the comment content.", "items": { "description": "A rich text object.", "properties": { "annotations": { "description": "Styling information for the text. By default, give nothing for default text.", "properties": { "bold": { "type": "boolean" }, "code": { "type": "boolean" }, "color": { "description": "Color for the text.", "enum": [ "default", "blue", "blue_background", "brown", "brown_background", "gray", "gray_background", "green", "green_background", "orange", "orange_background", "pink", "pink_background", "purple", "purple_background", "red", "red_background", "yellow", "yellow_background" ], "type": "string" }, "italic": { "type": "boolean" }, "strikethrough": { "type": "boolean" }, "underline": { "type": "boolean" } }, "type": "object" }, "equation": { "description": "Equation object if type is 'equation'. Represents an inline LaTeX equation.", "properties": { "expression": { "description": "LaTeX string representing the inline equation.", "type": "string" } }, "required": [ "expression" ], "type": "object" }, "href": { "description": "The URL of any link or mention in this text, if any. Do NOT provide a NULL value, just ignore this field if there is no link or mention.", "type": "string" }, "mention": { "description": "Mention object if type is 'mention'. Represents an inline mention of a database, date, link preview, page, template mention, or user.", "oneOf": [ { "required": [ "database" ] }, { "required": [ "date" ] }, { "required": [ "link_preview" ] }, { "required": [ "page" ] }, { "required": [ "template_mention" ] }, { "required": [ "user" ] } ], "properties": { "database": { "description": "Database mention object. Contains a database reference with an 'id' field.", "properties": { "id": { "description": "The ID of the mentioned database.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-).", "type": "string" } }, "required": [ "id" ], "type": "object" }, "date": { "description": "Date mention object, containing a date property value object.", "properties": { "end": { "description": "An ISO 8601 formatted end date or date-time, or null if not a range.", "type": [ "string", "null" ] }, "start": { "description": "An ISO 8601 formatted start date or date-time.", "type": "string" }, "time_zone": { "description": "Time zone information for start and end. If null, times are in UTC.", "type": [ "string", "null" ] } }, "required": [ "start" ], "type": "object" }, "link_preview": { "description": "Link Preview mention object, containing a URL for the link preview.", "properties": { "url": { "description": "The URL for the link preview.", "type": "string" } }, "required": [ "url" ], "type": "object" }, "page": { "description": "Page mention object, containing a page reference with an 'id' field.", "properties": { "id": { "description": "The ID of the mentioned page.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-).", "type": "string" } }, "required": [ "id" ], "type": "object" }, "template_mention": { "description": "Template mention object, can be a template_mention_date or template_mention_user.", "properties": { "template_mention_date": { "description": "For template_mention_date type, the date keyword.", "enum": [ "today", "now" ], "type": "string" }, "template_mention_user": { "description": "For template_mention_user type, the user keyword.", "enum": [ "me" ], "type": "string" }, "type": { "description": "The template mention type.", "enum": [ "template_mention_date", "template_mention_user" ], "type": "string" } }, "type": "object" }, "type": { "description": "The type of the mention.", "enum": [ "database", "date", "link_preview", "page", "template_mention", "user" ], "type": "string" }, "user": { "description": "User mention object, contains a user reference.", "properties": { "id": { "description": "The ID of the user.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-).", "type": "string" }, "object": { "description": "Should be 'user'.", "enum": [ "user" ], "type": "string" } }, "required": [ "object", "id" ], "type": "object" } }, "required": [ "type" ], "type": "object" }, "plain_text": { "description": "The plain text without annotations.", "type": "string" }, "text": { "description": "Object containing text content and optional link info. Required if type is 'text'.", "properties": { "content": { "description": "The actual text content.", "type": "string" }, "link": { "description": "Optional link object with a 'url' field. Do NOT provide a NULL value, just ignore this field no link.", "properties": { "url": { "description": "The URL the text links to.", "type": "string" } }, "type": "object" } }, "type": "object" }, "type": { "description": "The type of this rich text object. Possible values: text, mention, equation.", "enum": [ "text", "mention", "equation" ], "type": "string" } }, "required": [ "type" ], "type": "object" }, "type": "array" } }, "required": [ "rich_text" ], "type": "object" }