notion_append_block_children
Add new content blocks to an existing Notion page or block. Insert text, headings, lists, and other elements to expand your documents programmatically.
Instructions
Append new children blocks to a specified parent block in Notion. Requires insert content capabilities. You can optionally specify the 'after' parameter to append after a certain block.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| block_id | Yes | The ID of the parent block.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-). | |
| children | Yes | Array of block objects to append. Each block must follow the Notion block schema. | |
| after | No | The ID of the existing block that the new block should be appended after.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-). | |
| format | No | Specify the response format. 'json' returns the original data structure, 'markdown' returns a more readable format. Use 'markdown' when the user only needs to read the page and isn't planning to write or modify it. Use 'json' when the user needs to read the page with the intention of writing to or modifying it. | markdown |
Implementation Reference
- src/client/index.ts:33-49 (handler)Core implementation of the notion_append_block_children tool in NotionClientWrapper. Makes a PATCH request to the Notion API endpoint /blocks/{block_id}/children to append the provided children blocks.
async appendBlockChildren( block_id: string, children: Partial<BlockResponse>[] ): Promise<BlockResponse> { const body = { children }; const response = await fetch( `${this.baseUrl}/blocks/${block_id}/children`, { method: "PATCH", headers: this.headers, body: JSON.stringify(body), } ); return response.json(); } - src/server/index.ts:51-64 (handler)MCP server handler case for notion_append_block_children tool. Validates arguments and delegates execution to NotionClientWrapper.appendBlockChildren.
case "notion_append_block_children": { const args = request.params .arguments as unknown as args.AppendBlockChildrenArgs; if (!args.block_id || !args.children) { throw new Error( "Missing required arguments: block_id and children" ); } response = await notionClient.appendBlockChildren( args.block_id, args.children ); break; } - src/types/schemas.ts:14-41 (schema)Tool schema definition including name, description, and input schema for notion_append_block_children.
export const appendBlockChildrenTool: Tool = { name: "notion_append_block_children", description: "Append new children blocks to a specified parent block in Notion. Requires insert content capabilities. You can optionally specify the 'after' parameter to append after a certain block.", inputSchema: { type: "object", properties: { block_id: { type: "string", description: "The ID of the parent block." + commonIdDescription, }, children: { type: "array", description: "Array of block objects to append. Each block must follow the Notion block schema.", items: blockObjectSchema, }, after: { type: "string", description: "The ID of the existing block that the new block should be appended after." + commonIdDescription, }, format: formatParameter, }, required: ["block_id", "children"], }, }; - src/server/index.ts:302-325 (registration)Registration of the tool in the ListToolsRequestHandler. The appendBlockChildrenTool schema is included in the list of available tools, filtered by enabledToolsSet.
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), };