notion_retrieve_page
Retrieve Notion page content in JSON or Markdown format using the page ID for reading or modification purposes.
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/client/index.ts:102-109 (handler)The core implementation of the 'notion_retrieve_page' tool. Performs a GET request to the Notion API endpoint `/pages/{page_id}` to fetch the page data.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)Defines the tool schema: name, description, and inputSchema for 'notion_retrieve_page' used for validation and tool listing.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 (registration)Registers and handles the tool call in the MCP server switch statement, validates args, and delegates to NotionClientWrapper.retrievePage.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:309-309 (registration)Includes the retrievePageTool schema in the allTools array for ListTools response, enabling tool discovery.schemas.retrievePageTool,
- src/types/args.ts:39-42 (schema)TypeScript interface for tool arguments used in server for type assertion.export interface RetrievePageArgs { page_id: string; format?: "json" | "markdown"; }