Notion
notion-create-comment
Add a comment to a page or specific content. Creates a new comment. Provide `page_id` to identify the page, then choose ONE targeting mode: - `page_id` alone: Page-level comment on the entire page - `page_id` + `selection_with_ellipsis`: Comment on specific block content - `discussion_id`: Reply to an existing discussion thread (page_id is still required) For content targeting, use `selection_with_ellipsis` with ~10 chars from start and end: "# Section Ti...tle content" <example description="Page-level comment"> {"page_id": "uuid", "rich_text": [{"text": {"content": "Comment"}}]} </example> <example description="Comment on specific content"> {"page_id": "uuid", "selection_with_ellipsis": "# Meeting No...es heading", "rich_text": [{"text": {"content": "Comment on this section"}}]} </example> <example description="Reply to discussion"> {"page_id": "uuid", "discussion_id": "discussion://pageId/blockId/discussionId", "rich_text": [{"text": {"content": "Reply"}}]} </example>
Remote notion
Other tools also called notion-create-comment?
See providers with this name
Input Schema
{
"type": "object",
"properties": {
"page_id": {
"type": "string",
"description": "The ID of the page to comment on (with or without dashes)."
},
"rich_text": {
"type": "array",
"items": {
"allOf": [
{
"type": "object",
"properties": {
"annotations": {
"type": "object",
"properties": {
"bold": {
"type": "boolean"
},
"code": {
"type": "boolean"
},
"color": {
"type": "string"
},
"italic": {
"type": "boolean"
},
"underline": {
"type": "boolean"
},
"strikethrough": {
"type": "boolean"
}
},
"description": "All rich text objects contain an annotations object that sets the styling for the rich text.",
"additionalProperties": true
}
},
"additionalProperties": true
},
{
"anyOf": [
{
"type": "object",
"required": [
"text"
],
"properties": {
"text": {
"type": "object",
"required": [
"content"
],
"properties": {
"link": {
"anyOf": [
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "The URL of the link."
}
},
"additionalProperties": true
},
{
"type": "null"
}
],
"description": "An object with information about any inline link in this text, if included."
},
"content": {
"type": "string",
"maxLength": 2000,
"description": "The actual text content of the text."
}
},
"description": "If a rich text object's type value is `text`, then the corresponding text field contains an object including the text content and any inline link.",
"additionalProperties": false
},
"type": {
"enum": [
"text"
],
"type": "string"
}
},
"additionalProperties": true
},
{
"type": "object",
"required": [
"mention"
],
"properties": {
"type": {
"enum": [
"mention"
],
"type": "string"
},
"mention": {
"anyOf": [
{
"type": "object",
"required": [
"user"
],
"properties": {
"type": {
"enum": [
"user"
],
"type": "string"
},
"user": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The ID of the user."
},
"object": {
"enum": [
"user"
],
"type": "string"
}
},
"description": "Details of the user mention.",
"additionalProperties": true
}
},
"additionalProperties": true
},
{
"type": "object",
"required": [
"date"
],
"properties": {
"date": {
"type": "object",
"required": [
"start"
],
"properties": {
"end": {
"anyOf": [
{
"type": "string",
"format": "date"
},
{
"type": "null"
}
],
"description": "The end date of the date object, if any."
},
"start": {
"type": "string",
"format": "date",
"description": "The start date of the date object."
},
"time_zone": {
"type": [
"string",
"null"
],
"description": "The time zone of the date object, if any. E.g. America/Los_Angeles, Europe/London, etc."
}
},
"description": "Details of the date mention.",
"additionalProperties": false
},
"type": {
"enum": [
"date"
],
"type": "string"
}
},
"additionalProperties": true
},
{
"type": "object",
"required": [
"page"
],
"properties": {
"page": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The ID of the page in the mention."
}
},
"description": "Details of the page mention.",
"additionalProperties": true
},
"type": {
"enum": [
"page"
],
"type": "string"
}
},
"additionalProperties": true
},
{
"type": "object",
"required": [
"database"
],
"properties": {
"type": {
"enum": [
"database"
],
"type": "string"
},
"database": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The ID of the database in the mention."
}
},
"description": "Details of the database mention.",
"additionalProperties": true
}
},
"additionalProperties": true
},
{
"type": "object",
"required": [
"template_mention"
],
"properties": {
"type": {
"enum": [
"template_mention"
],
"type": "string"
},
"template_mention": {
"anyOf": [
{
"type": "object",
"required": [
"template_mention_date"
],
"properties": {
"type": {
"enum": [
"template_mention_date"
],
"type": "string"
},
"template_mention_date": {
"enum": [
"today",
"now"
],
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"template_mention_user"
],
"properties": {
"type": {
"enum": [
"template_mention_user"
],
"type": "string"
},
"template_mention_user": {
"enum": [
"me"
],
"type": "string"
}
},
"additionalProperties": false
}
],
"description": "Details of the template mention."
}
},
"additionalProperties": true
},
{
"type": "object",
"required": [
"custom_emoji"
],
"properties": {
"type": {
"enum": [
"custom_emoji"
],
"type": "string"
},
"custom_emoji": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The ID of the custom emoji."
},
"url": {
"type": "string",
"description": "The URL of the custom emoji."
},
"name": {
"type": "string",
"description": "The name of the custom emoji."
}
},
"description": "Details of the custom emoji mention.",
"additionalProperties": true
}
},
"additionalProperties": true
}
],
"description": "Mention objects represent an inline mention of a database, date, link preview mention, page, template mention, or user. A mention is created in the Notion UI when a user types `@` followed by the name of the reference."
}
},
"additionalProperties": true
},
{
"type": "object",
"required": [
"equation"
],
"properties": {
"type": {
"enum": [
"equation"
],
"type": "string"
},
"equation": {
"type": "object",
"required": [
"expression"
],
"properties": {
"expression": {
"type": "string",
"description": "A KaTeX compatible string."
}
},
"description": "Notion supports inline LaTeX equations as rich text objects with a type value of `equation`.",
"additionalProperties": true
}
},
"additionalProperties": true
}
]
}
]
},
"maxItems": 100,
"description": "An array of rich text objects that represent the content of the comment."
},
"discussion_id": {
"type": "string",
"description": "The ID or URL of an existing discussion to reply to (e.g., discussion://pageId/blockId/discussionId)."
},
"selection_with_ellipsis": {
"type": "string",
"description": "Unique start and end snippet of the content to comment on. DO NOT provide the entire string. Instead, provide up to the first ~10 characters, an ellipsis, and then up to the last ~10 characters. Make sure you provide enough of the start and end snippet to uniquely identify the content. For example: \"# Section heading...last paragraph.\""
}
}
}