notion_retrieve_page
Retrieve Notion page content in JSON or Markdown format for reading, writing, or modification purposes.
Instructions
Retrieve a page from Notion
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| 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 (-). | |
| 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/server/index.ts:113-121 (handler)MCP server handler case for the 'notion_retrieve_page' tool. Validates the page_id argument and delegates execution to the NotionClientWrapper's 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 via Notion API GET /pages/{page_id} in the NotionClientWrapper class.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', including name, description, and input validation schema.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-325 (registration)Registration of the tool in the ListToolsRequestHandler by including retrievePageTool in the list of available tools, which are filtered based on 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 (helper)TypeScript interface defining the arguments for the notion_retrieve_page tool.export interface RetrievePageArgs { page_id: string; format?: "json" | "markdown"; }