notion-mcp-server

Instructions

Implementation Reference

• src/tools/batchAppendBlockChildren.ts:6-40 (handler)

  The main handler function for the batch_append_block_children tool. It loops through the provided operations, appends children to each specified block using the Notion API, collects results, and returns a formatted response or handles errors.

  export const batchAppendBlockChildren = async (
    params: BatchAppendBlockChildrenParams
  ): Promise<CallToolResult> => {
    try {
      const results = [];
  
      for (const operation of params.operations) {
        const response = await notion.blocks.children.append({
          block_id: operation.blockId,
          children: operation.children,
        });
  
        results.push({
          blockId: operation.blockId,
          success: true,
          response,
        });
      }
  
      return {
        content: [
          {
            type: "text",
            text: `Successfully completed ${params.operations.length} append operations`,
          },
          {
            type: "text",
            text: JSON.stringify(results, null, 2),
          },
        ],
      };
    } catch (error) {
      return handleNotionError(error);
    }
  };

• src/schema/blocks.ts:192-205 (schema)

  Zod schema defining the input parameters for batch_append_block_children, consisting of an array of operations each with blockId and children.

  export const BATCH_APPEND_BLOCK_CHILDREN_SCHEMA = {
    operations: z
      .array(
        z.object({
          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"),
        })
      )
      .describe("Array of append operations to perform in a single batch"),
  };

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

  Registration/dispatch case in the blocks operation tool that calls the batchAppendBlockChildren handler when the action is 'batch_append_block_children'.

  case "batch_append_block_children":
    return batchAppendBlockChildren(params.payload.params);

• src/schema/blocks.ts:288-295 (schema)

  Part of the BLOCKS_OPERATION_SCHEMA discriminated union that defines the structure for the batch_append_block_children action including its literal action name and params schema.

  z.object({
    action: z
      .literal("batch_append_block_children")
      .describe(
        "Use this action to perform batch append operations on blocks."
      ),
    params: z.object(BATCH_APPEND_BLOCK_CHILDREN_SCHEMA),
  }),

• src/types/blocks.ts:36-41 (schema)

  TypeScript type definition and schema wrapper for BatchAppendBlockChildrenParams inferred from the schema.

  export const batchAppendBlockChildrenSchema = z.object(
    BATCH_APPEND_BLOCK_CHILDREN_SCHEMA
  );
  export type BatchAppendBlockChildrenParams = z.infer<
    typeof batchAppendBlockChildrenSchema
  >;