notion_delete_block
Remove unwanted content from Notion pages by deleting specific blocks using their unique ID. Choose JSON format for programmatic access or Markdown for readability.
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/client/index.ts:80-87 (handler)The core handler function in NotionClientWrapper that executes the DELETE request to the Notion API endpoint /blocks/{block_id} to delete the block.
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:90-98 (handler)The tool dispatch handler in the MCP server's CallToolRequest handler that validates the input arguments and calls the NotionClientWrapper's deleteBlock method.
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, including name, description, and input schema specifying the 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:307-307 (registration)Registration of the deleteBlockTool schema in the array of available tools returned by the ListToolsRequest handler.
schemas.deleteBlockTool,