notion_update_page_properties
Update properties of Notion pages or database items by specifying page ID and property values to modify content in your workspace.
Instructions
Update properties of a page or an item in a Notion database
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| 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 |
| page_id | Yes | The ID of the page or database item to update.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-). | |
| properties | Yes | Properties to update. These correspond to the columns or fields in the database. |
Implementation Reference
- src/client/index.ts:111-124 (handler)Core implementation of the notion_update_page_properties tool. Performs a PATCH request to the Notion API /pages/{page_id} endpoint to update the page properties.async updatePageProperties( page_id: string, properties: Record<string, any> ): Promise<PageResponse> { const body = { properties }; const response = await fetch(`${this.baseUrl}/pages/${page_id}`, { method: "PATCH", headers: this.headers, body: JSON.stringify(body), }); return response.json(); }
- src/types/schemas.ts:138-159 (schema)Defines the Tool object with name, description, and input schema for the notion_update_page_properties tool.export const updatePagePropertiesTool: Tool = { name: "notion_update_page_properties", description: "Update properties of a page or an item in a Notion database", inputSchema: { type: "object", properties: { page_id: { type: "string", description: "The ID of the page or database item to update." + commonIdDescription, }, properties: { type: "object", description: "Properties to update. These correspond to the columns or fields in the database.", }, format: formatParameter, }, required: ["page_id", "properties"], }, };
- src/server/index.ts:302-326 (registration)Registers the tool by including updatePagePropertiesTool in the allTools array returned in ListToolsRequestHandler.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), }; });
- src/server/index.ts:123-135 (handler)Server-side dispatcher for the tool call, validates arguments and delegates to NotionClientWrapper.updatePageProperties.case "notion_update_page_properties": { const args = request.params .arguments as unknown as args.UpdatePagePropertiesArgs; if (!args.page_id || !args.properties) { throw new Error( "Missing required arguments: page_id and properties" ); } response = await notionClient.updatePageProperties( args.page_id, args.properties ); break;