notion_update_block
Modify content in Notion blocks by replacing entire fields. Specify block ID and updated content matching the block type schema.
Instructions
Update the content of a block in Notion based on its type. The update replaces the entire value for a given field.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| block_id | Yes | The ID of the block to update.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-). | |
| block | Yes | The updated content for the block. Must match the block's type schema. | |
| 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:89-100 (handler)Core handler function in NotionClientWrapper that executes the Notion API PATCH request to update a block.async updateBlock( block_id: string, block: Partial<BlockResponse> ): Promise<BlockResponse> { const response = await fetch(`${this.baseUrl}/blocks/${block_id}`, { method: "PATCH", headers: this.headers, body: JSON.stringify(block), }); return response.json(); }
- src/server/index.ts:100-111 (handler)Dispatch handler in MCP server that validates arguments and delegates to NotionClientWrapper.updateBlock.case "notion_update_block": { const args = request.params .arguments as unknown as args.UpdateBlockArgs; if (!args.block_id || !args.block) { throw new Error("Missing required arguments: block_id and block"); } response = await notionClient.updateBlock( args.block_id, args.block ); break; }
- src/types/schemas.ts:99-119 (schema)Tool schema definition including name, description, and input validation schema.export const updateBlockTool: Tool = { name: "notion_update_block", description: "Update the content of a block in Notion based on its type. The update replaces the entire value for a given field.", inputSchema: { type: "object", properties: { block_id: { type: "string", description: "The ID of the block to update." + commonIdDescription, }, block: { type: "object", description: "The updated content for the block. Must match the block's type schema.", }, format: formatParameter, }, required: ["block_id", "block"], }, };
- src/server/index.ts:308-308 (registration)Registration of the tool schema in the list of available tools for ListToolsRequest.schemas.updateBlockTool,