notion_retrieve_comments

Instructions

Implementation Reference

• src/client/index.ts:271-290 (handler)

  Core implementation of the notion_retrieve_comments tool: constructs query params for block_id and pagination, then fetches from Notion API /comments endpoint.

  async retrieveComments(
    block_id: string,
    start_cursor?: string,
    page_size?: number
  ): Promise<ListResponse> {
    const params = new URLSearchParams();
    params.append("block_id", block_id);
    if (start_cursor) params.append("start_cursor", start_cursor);
    if (page_size) params.append("page_size", page_size.toString());
  
    const response = await fetch(
      `${this.baseUrl}/comments?${params.toString()}`,
      {
        method: "GET",
        headers: this.headers,
      }
    );
  
    return response.json();
  }

• src/types/schemas.ts:398-424 (schema)

  Schema definition for the notion_retrieve_comments tool, including name, description, and input schema with required block_id and optional pagination/format.

  export const retrieveCommentsTool: Tool = {
    name: "notion_retrieve_comments",
    description:
      "Retrieve a list of unresolved comments from a Notion page or block. Requires the integration to have 'read comment' capabilities.",
    inputSchema: {
      type: "object",
      properties: {
        block_id: {
          type: "string",
          description:
            "The ID of the block or page whose comments you want to retrieve." +
            commonIdDescription,
        },
        start_cursor: {
          type: "string",
          description:
            "If supplied, returns a page of results starting after the cursor.",
        },
        page_size: {
          type: "number",
          description: "Number of comments to retrieve (max 100).",
        },
        format: formatParameter,
      },
      required: ["block_id"],
    },
  };

• src/server/index.ts:237-249 (handler)

  Server-side handler case for notion_retrieve_comments: validates arguments and calls NotionClientWrapper.retrieveComments.

  case "notion_retrieve_comments": {
    const args = request.params
      .arguments as unknown as args.RetrieveCommentsArgs;
    if (!args.block_id) {
      throw new Error("Missing required argument: block_id");
    }
    response = await notionClient.retrieveComments(
      args.block_id,
      args.start_cursor,
      args.page_size
    );
    break;
  }

• src/server/index.ts:302-326 (registration)

  Registers the notion_retrieve_comments tool (as schemas.retrieveCommentsTool) in the list of available tools returned by ListToolsRequest.

  server.setRequestHandler(ListToolsRequestSchema, async () => {
    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),
    };
  });