notion_retrieve_page
Retrieve Notion pages in JSON or Markdown format using page IDs to access content for reading or modification.
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:138-145 (handler)The actual implementation of retrievePage method that makes a GET request to Notion's /pages/{page_id} endpoint to retrieve page dataasync retrievePage(page_id: string): Promise<PageResponse> { const response = await fetch(`${this.baseUrl}/pages/${page_id}`, { method: "GET", headers: this.headers, }); return response.json(); }
- src/server/index.ts:128-136 (registration)The request handler case for 'notion_retrieve_page' that validates the page_id argument and calls the client's retrievePage methodcase "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/types/schemas.ts:157-171 (schema)The MCP tool schema definition for 'notion_retrieve_page' specifying the input parameters (page_id, format) and descriptionexport 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/types/args.ts:46-49 (schema)TypeScript interface defining the arguments type for the retrievePage tool (page_id and optional format parameter)export interface RetrievePageArgs { page_id: string; format?: "json" | "markdown"; }
- src/server/index.ts:324-325 (registration)Registration of the retrievePageTool in the allTools array that gets returned by the ListToolsRequestSchema handlerschemas.createPageTool, schemas.retrievePageTool,