notion_update_page_properties
Modify properties of Notion pages or database items to update columns and fields with new values.
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:111-124 (handler)Core implementation of the tool: sends PATCH request to Notion API /pages/{page_id} 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/server/index.ts:123-136 (handler)Server-side dispatch handler for the tool call, validates arguments and delegates to NotionClientWrapper.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:138-159 (schema)MCP tool schema definition including name, description, and input validation schema.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)Registration of the tool in the ListToolsRequest handler by including its schema in the allTools array.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/types/args.ts:44-48 (schema)TypeScript type definition for the tool arguments used in the server handler.export interface UpdatePagePropertiesArgs { page_id: string; properties: Record<string, any>; format?: "json" | "markdown"; }