notion_update_block

Instructions

Implementation Reference

• src/server/index.ts:100-110 (handler)

  MCP tool handler for 'notion_update_block': validates input arguments (block_id and block), then delegates to notionClient.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 defining name, description, input schema (block_id, block, optional format) for 'notion_update_block'.

  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/client/index.ts:89-100 (helper)

  Core implementation in NotionClientWrapper: sends PATCH request to Notion API endpoint /blocks/{block_id} with the block update payload.

  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:302-326 (registration)

  Tool registration: includes updateBlockTool (schemas.updateBlockTool) in the list of available tools returned by ListToolsRequest.

  server.setRequestHandler(ListToolsRequestSchema, async () => {
    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,
    ];
    return {
      tools: filterTools(allTools, enabledToolsSet),
    };
  });