notion_update_page_properties
Modify properties of Notion pages or database items by specifying page ID and property updates to change fields like status, dates, or tags.
Instructions
Update properties of a page or an item in a Notion database
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| 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. | |
| 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:147-160 (handler)Core implementation of updatePageProperties method that makes a PATCH request to the Notion API to update 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/server/index.ts:138-150 (handler)Tool request handler that validates arguments and calls the updatePageProperties method on the Notion client
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; - src/types/schemas.ts:173-194 (schema)Tool schema definition with name, description, inputSchema (page_id and properties as required fields)
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/types/args.ts:51-55 (schema)TypeScript interface definition for UpdatePagePropertiesArgs including page_id, properties, and optional format
export interface UpdatePagePropertiesArgs { page_id: string; properties: Record<string, any>; format?: "json" | "markdown"; } - src/server/index.ts:317-342 (registration)Tool registration in ListToolsRequestSchema handler where updatePagePropertiesTool is included in the allTools array
server.setRequestHandler(ListToolsRequestSchema, async () => { const allTools = [ schemas.appendBlockChildrenTool, schemas.retrieveBlockTool, schemas.retrieveBlockChildrenTool, schemas.deleteBlockTool, schemas.updateBlockTool, schemas.createPageTool, 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), }; });