notion-mcp-server

Instructions

Implementation Reference

• src/tools/appendBlockChildren.ts:6-30 (handler)

  The main handler function that executes the append_block_children tool logic by calling the Notion API to append child blocks to a specified block.

  export const appendBlockChildren = async (
    params: AppendBlockChildrenParams
  ): Promise<CallToolResult> => {
    try {
      const response = await notion.blocks.children.append({
        block_id: params.blockId,
        children: params.children,
      });
  
      return {
        content: [
          {
            type: "text",
            text: `Successfully appended ${params.children.length} block(s) to ${params.blockId}`,
          },
          {
            type: "text",
            text: `Block ID: ${JSON.stringify(response, null, 2)}`,
          },
        ],
      };
    } catch (error) {
      return handleNotionError(error);
    }
  };

• src/tools/blocks.ts:18-19 (registration)

  Registers and dispatches the append_block_children action within the blocks operation tool handler by calling the specific appendBlockChildren function.

  case "append_block_children":
    return appendBlockChildren(params.payload.params);

• src/schema/blocks.ts:159-164 (schema)

  Zod schema defining the input parameters for the append_block_children tool: blockId (string) and children (array of text block requests).

  export const APPEND_BLOCK_CHILDREN_SCHEMA = {
    blockId: z.string().describe("The ID of the block to append children to"),
    children: z
      .array(TEXT_BLOCK_REQUEST_SCHEMA)
      .describe("Array of blocks to append as children"),
  };

• src/schema/blocks.ts:260-262 (schema)

  Part of the BLOCKS_OPERATION_SCHEMA defining the discriminated union for the append_block_children action including its literal action name and params reference.

    .literal("append_block_children")
    .describe("Use this action to append children to a block."),
  params: z.object(APPEND_BLOCK_CHILDREN_SCHEMA),

• src/tools/blocks.ts:4-4 (registration)

  Import statement registering the appendBlockChildren handler for use in the blocks operation dispatcher.

  import { appendBlockChildren } from "./appendBlockChildren.js";