notion_delete_block
Remove unwanted content from Notion pages by deleting specific blocks using their unique ID, with optional JSON or Markdown response formats.
Instructions
Delete a block in Notion
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| block_id | Yes | The ID of the block to delete.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/server/index.ts:90-97 (handler)The handler logic for the "notion_delete_block" tool. It extracts arguments, validates the presence of block_id, and delegates to notionClient.deleteBlock() to perform the deletion.case "notion_delete_block": { const args = request.params .arguments as unknown as args.DeleteBlockArgs; if (!args.block_id) { throw new Error("Missing required argument: block_id"); } response = await notionClient.deleteBlock(args.block_id); break;
- src/types/schemas.ts:83-97 (schema)The schema definition for the "notion_delete_block" tool, specifying name, description, input schema with required block_id, and optional format.export const deleteBlockTool: Tool = { name: "notion_delete_block", description: "Delete a block in Notion", inputSchema: { type: "object", properties: { block_id: { type: "string", description: "The ID of the block to delete." + commonIdDescription, }, format: formatParameter, }, required: ["block_id"], }, };
- src/client/index.ts:80-86 (helper)The core implementation of block deletion in the NotionClientWrapper class, making a DELETE request to the Notion API endpoint /blocks/{block_id}.async deleteBlock(block_id: string): Promise<BlockResponse> { const response = await fetch(`${this.baseUrl}/blocks/${block_id}`, { method: "DELETE", headers: this.headers, }); return response.json();
- src/server/index.ts:303-322 (registration)The tool is registered by including schemas.deleteBlockTool (at line 307) in the allTools array returned by the ListToolsRequestSchema handler.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, ];
- src/types/args.ts:27-29 (helper)Type definition for the arguments expected by the notion_delete_block tool handler.export interface DeleteBlockArgs { block_id: string; format?: "json" | "markdown";