notion_create_comment
Add comments to Notion pages or existing discussion threads to provide feedback, ask questions, or share information within your workspace.
Instructions
Create a comment in Notion. This requires the integration to have 'insert comment' capabilities. You can either specify a page parent or a discussion_id, but not both.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| parent | No | Parent object that specifies the page to comment on. Must include a page_id if used. | |
| discussion_id | No | 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 (-). | |
| rich_text | Yes | Array of rich text objects representing the comment content. | |
| format | No | 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. | markdown |
Implementation Reference
- src/client/index.ts:249-269 (handler)The core handler function in NotionClientWrapper that performs the POST request to the Notion API /comments endpoint to create a comment.async createComment( parent?: { page_id: string }, discussion_id?: string, rich_text?: RichTextItemResponse[] ): Promise<CommentResponse> { const body: Record<string, any> = { rich_text }; if (parent) { body.parent = parent; } if (discussion_id) { body.discussion_id = discussion_id; } const response = await fetch(`${this.baseUrl}/comments`, { method: "POST", headers: this.headers, body: JSON.stringify(body), }); return response.json(); }
- src/types/schemas.ts:361-396 (schema)Defines the Tool schema including name, description, and inputSchema for 'notion_create_comment'.export const createCommentTool: Tool = { name: "notion_create_comment", description: "Create a comment in Notion. This requires the integration to have 'insert comment' capabilities. You can either specify a page parent or a discussion_id, but not both.", inputSchema: { type: "object", properties: { parent: { type: "object", description: "Parent object that specifies the page to comment on. Must include a page_id if used.", properties: { page_id: { type: "string", description: "The ID of the page to comment on." + commonIdDescription, }, }, }, discussion_id: { type: "string", description: "The ID of an existing discussion thread to add a comment to." + commonIdDescription, }, rich_text: { type: "array", description: "Array of rich text objects representing the comment content.", items: richTextObjectSchema, }, format: formatParameter, }, required: ["rich_text"], }, };
- src/server/index.ts:219-235 (registration)Switch case in CallToolRequest handler that validates arguments and dispatches to the client handler for 'notion_create_comment'.case "notion_create_comment": { const args = request.params .arguments as unknown as args.CreateCommentArgs; if (!args.parent && !args.discussion_id) { throw new Error( "Either parent.page_id or discussion_id must be provided" ); } response = await notionClient.createComment( args.parent, args.discussion_id, args.rich_text ); break; }
- src/server/index.ts:303-322 (registration)Includes createCommentTool in the list of available tools returned by ListToolsRequest handler.const allTools = [ schemas.appendBlockChildrenTool, schemas.retrieveBlockTool, schemas.retrieveBlockChildrenTool, schemas.deleteBlockTool, schemas.updateBlockTool, schemas.retrievePageTool, schemas.updatePagePropertiesTool, schemas.listAllUsersTool, schemas.retrieveUserTool, schemas.retrieveBotUserTool, schemas.createDatabaseTool, schemas.queryDatabaseTool, schemas.retrieveDatabaseTool, schemas.updateDatabaseTool, schemas.createDatabaseItemTool, schemas.createCommentTool, schemas.retrieveCommentsTool, schemas.searchTool, ];
- src/types/args.ts:113-118 (helper)TypeScript interface defining the argument types used in the server dispatch for 'notion_create_comment'.export interface CreateCommentArgs { parent?: { page_id: string }; discussion_id?: string; rich_text: RichTextItemResponse[]; format?: "json" | "markdown"; }