notion_retrieve_page
Retrieve Notion pages in JSON or Markdown format to access content for reading or programmatic use.
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/client/index.ts:102-109 (handler)Core handler implementation that makes the HTTP GET request to the Notion API to retrieve the page by ID and returns the PageResponse.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 including name, description, and input schema for validating tool arguments.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:113-121 (handler)MCP server handler case that validates arguments and delegates 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/server/index.ts:302-326 (registration)Registration of the tool in the ListToolsRequest handler by including retrievePageTool in the list of available tools.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 type definition for the tool arguments used in the server handler.export interface RetrievePageArgs { page_id: string; format?: "json" | "markdown"; }