Notion MCP Server

Instructions

Implementation Reference

• server.js:513-537 (handler)

  Executes the get-block-children tool by calling Notion's blocks.children.list API with the provided block_id, optional pagination parameters, formats block_id by removing dashes, and returns the JSON response as text content.

  else if (name === "get-block-children") {
    let { block_id, start_cursor, page_size } = args;
    
    // Remove dashes if present in block_id
    block_id = block_id.replace(/-/g, "");
  
    const params = {
      block_id,
      page_size: page_size || 100,
    };
  
    if (start_cursor) {
      params.start_cursor = start_cursor;
    }
  
    const response = await notion.blocks.children.list(params);
  
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(response, null, 2),
        },
      ],
    };

• server.js:197-219 (schema)

  Defines the input schema for the get-block-children tool, specifying required block_id and optional pagination parameters.

  {
    name: "get-block-children",
    description: "Retrieve the children blocks of a block",
    inputSchema: {
      type: "object",
      properties: {
        block_id: {
          type: "string",
          description: "ID of the block (page or block)"
        },
        start_cursor: {
          type: "string",
          description: "Cursor for pagination"
        },
        page_size: {
          type: "number",
          description: "Number of results per page",
          default: 100
        }
      },
      required: ["block_id"]
    }
  },