get-block-children
Retrieve child blocks from a Notion page or block to access nested content and structure. Use this tool to fetch sub-blocks for analysis or processing within your Notion workspace.
Instructions
Retrieve the children blocks of a block
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| block_id | Yes | ID of the block (page or block) | |
| start_cursor | No | Cursor for pagination | |
| page_size | No | Number of results per page |
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"] } },