notion_update_block
Modify content in Notion blocks by replacing field values according to block type specifications. Supports JSON or Markdown response formats for different use cases.
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:125-136 (handler)The actual implementation of the updateBlock method that makes a PATCH request to Notion's API 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:101-112 (registration)The switch case handler that routes 'notion_update_block' tool requests to the client's updateBlock method
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)The MCP Tool schema definition for 'notion_update_block' that defines input validation
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/types/args.ts:32-36 (schema)TypeScript interface definition for UpdateBlockArgs type
export interface UpdateBlockArgs { block_id: string; block: Partial<BlockResponse>; format?: "json" | "markdown"; }