notion_retrieve_page
Retrieve a Notion page by its ID in either JSON or Markdown format. Use JSON for programmatic access and Markdown for readability. Integrate with the Notion MCP Server for optimized workspace interactions.
Instructions
Retrieve a page from Notion
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 to retrieve.It should be a 32-character string (excluding hyphens) formatted as 8-4-4-4-12 with hyphens (-). |
Implementation Reference
- src/server/index.ts:113-121 (handler)MCP server handler for the 'notion_retrieve_page' tool. Validates the page_id argument and delegates execution to the NotionClientWrapper.retrievePage method.case "notion_retrieve_page": { const args = request.params .arguments as unknown as args.RetrievePageArgs; if (!args.page_id) { throw new Error("Missing required argument: page_id"); } response = await notionClient.retrievePage(args.page_id); break; }
- src/client/index.ts:102-109 (handler)Core implementation of page retrieval using Notion API fetch call to /pages/{page_id} endpoint.async retrievePage(page_id: string): Promise<PageResponse> { const response = await fetch(`${this.baseUrl}/pages/${page_id}`, { method: "GET", headers: this.headers, }); return response.json(); }
- src/types/schemas.ts:122-136 (schema)Tool schema definition for 'notion_retrieve_page', specifying input schema with required page_id and optional format.export const retrievePageTool: Tool = { name: "notion_retrieve_page", description: "Retrieve a page from Notion", inputSchema: { type: "object", properties: { page_id: { type: "string", description: "The ID of the page to retrieve." + commonIdDescription, }, format: formatParameter, }, required: ["page_id"], }, };
- src/server/index.ts:302-326 (registration)Tool registration in the ListToolsRequestHandler where retrievePageTool is included in the list of available tools, filtered by enabledToolsSet.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:39-42 (schema)TypeScript interface for arguments used in the tool handler for type assertion.export interface RetrievePageArgs { page_id: string; format?: "json" | "markdown"; }