notion-mcp-server

Instructions

Implementation Reference

• src/tools/batchDeleteBlocks.ts:6-39 (handler)

  The core handler function `batchDeleteBlocks` that loops through an array of block IDs and deletes each block using the Notion API's blocks.delete method. It collects results and returns a formatted response indicating success or handles errors.

  export const batchDeleteBlocks = async (
    params: BatchDeleteBlocksParams
  ): Promise<CallToolResult> => {
    try {
      const results = [];
  
      for (const blockId of params.blockIds) {
        const response = await notion.blocks.delete({
          block_id: blockId,
        });
  
        results.push({
          blockId,
          success: true,
          response,
        });
      }
  
      return {
        content: [
          {
            type: "text",
            text: `Successfully deleted ${params.blockIds.length} blocks (moved to trash)`,
          },
          {
            type: "text",
            text: JSON.stringify(results, null, 2),
          },
        ],
      };
    } catch (error) {
      return handleNotionError(error);
    }
  };

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

  Within the main `registerBlocksOperationTool` dispatcher, the case for action 'batch_delete_blocks' invokes the specific batchDeleteBlocks handler.

  case "batch_delete_blocks":
    return batchDeleteBlocks(params.payload.params);

• src/schema/blocks.ts:218-222 (schema)

  Zod schema defining the input parameters for batch_delete_blocks: an array of block ID strings.

  export const BATCH_DELETE_BLOCKS_SCHEMA = {
    blockIds: z
      .array(z.string().describe("The ID of a block to delete/archive"))
      .describe("Array of block IDs to delete in a single batch"),
  };

• src/schema/blocks.ts:304-311 (schema)

  Part of the BLOCKS_OPERATION_SCHEMA discriminated union, defining the 'batch_delete_blocks' action with its literal value and associated params schema.

  z.object({
    action: z
      .literal("batch_delete_blocks")
      .describe(
        "Use this action to perform batch delete operations on blocks."
      ),
    params: z.object(BATCH_DELETE_BLOCKS_SCHEMA),
  }),

• src/types/blocks.ts:46-47 (schema)

  Exports the full Zod schema object and infers the TypeScript type for BatchDeleteBlocksParams.

  export const batchDeleteBlocksSchema = z.object(BATCH_DELETE_BLOCKS_SCHEMA);
  export type BatchDeleteBlocksParams = z.infer<typeof batchDeleteBlocksSchema>;