get-block-children
Retrieve child blocks of a page or block in Notion using a block ID. Supports pagination to manage large datasets and integrate with AI assistants via the Notion MCP Server.
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) | |
| page_size | No | Number of results per page | |
| start_cursor | No | Cursor for pagination |
Implementation Reference
- server.js:195-217 (schema)Tool schema definition and registration in the tools/list response, including input schema for block_id, start_cursor, and page_size.
{ 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"] } }, - server.js:511-536 (handler)Handler implementation for get-block-children tool. Cleans block_id, constructs params, calls notion.blocks.children.list API, and returns JSON response.
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), }, ], }; }