notion_create_comment

Instructions

Implementation Reference

• src/server/index.ts:219-235 (handler)

  MCP tool handler for 'notion_create_comment': validates input arguments and calls NotionClientWrapper.createComment method.

  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/types/schemas.ts:361-396 (schema)

  Input schema and metadata definition for the 'notion_create_comment' tool.

  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:303-325 (registration)

  Registration of 'notion_create_comment' tool (as schemas.createCommentTool) in the list of available tools returned by ListToolsRequest.

  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,
  ];
  return {
    tools: filterTools(allTools, enabledToolsSet),
  };

• src/client/index.ts:249-269 (helper)

  Core implementation of comment creation via Notion API POST /comments endpoint in NotionClientWrapper.

  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();
  }