notion_delete_block
Remove unwanted content blocks from Notion pages using block ID to maintain clean and organized workspaces.
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:91-99 (handler)Handler for notion_delete_block tool - validates block_id argument and calls notionClient.deleteBlock()
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/client/index.ts:116-123 (handler)Implementation of deleteBlock method in NotionClientWrapper - makes DELETE request to Notion API /blocks/{block_id} endpoint
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/types/schemas.ts:83-97 (schema)Schema definition for notion_delete_block tool - defines name, description, and input schema with required block_id parameter
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/server/index.ts:317-342 (registration)Tool registration in ListToolsRequestSchema handler - adds deleteBlockTool to the list of available tools
server.setRequestHandler(ListToolsRequestSchema, async () => { const allTools = [ schemas.appendBlockChildrenTool, schemas.retrieveBlockTool, schemas.retrieveBlockChildrenTool, schemas.deleteBlockTool, schemas.updateBlockTool, schemas.createPageTool, 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), }; }); - src/types/args.ts:27-30 (schema)Type definition for DeleteBlockArgs interface - specifies block_id as string and optional format parameter
export interface DeleteBlockArgs { block_id: string; format?: "json" | "markdown"; }