get-page
Retrieve specific page data from Notion workspaces by providing the page ID. Enables Claude and other LLMs to access and interact with Notion content programmatically.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pageId | Yes |
Implementation Reference
- src/index.ts:98-160 (handler)The main handler function for the 'get-page' tool. It retrieves a Notion page by ID using notion.pages.retrieve, fetches its child blocks with notion.blocks.children.list, extracts and formats the content from various block types (paragraphs, headings, lists), extracts the page title from properties, and returns markdown-formatted content or an error.
async ({ pageId }) => { try { // Get the page const page = await notion.pages.retrieve({ page_id: pageId }); // Get page blocks (content) const blocks = await notion.blocks.children.list({ block_id: pageId }); // Extract text from blocks const content = blocks.results.map((block: any) => { if (block.type === 'paragraph') { return block.paragraph.rich_text.map((text: any) => text.plain_text).join(''); } if (block.type === 'heading_1') { return `# ${block.heading_1.rich_text.map((text: any) => text.plain_text).join('')}`; } if (block.type === 'heading_2') { return `## ${block.heading_2.rich_text.map((text: any) => text.plain_text).join('')}`; } if (block.type === 'heading_3') { return `### ${block.heading_3.rich_text.map((text: any) => text.plain_text).join('')}`; } if (block.type === 'bulleted_list_item') { return `• ${block.bulleted_list_item.rich_text.map((text: any) => text.plain_text).join('')}`; } if (block.type === 'numbered_list_item') { return `1. ${block.numbered_list_item.rich_text.map((text: any) => text.plain_text).join('')}`; } return ''; }).filter(Boolean).join('\n\n'); // Safely extract title from page let titleText = 'Untitled'; // Type assertion to access properties as any const pageAny = page as any; if (pageAny.properties) { // Find the first property that's a title const titleProp = Object.values(pageAny.properties).find( (prop: any) => prop.type === 'title' ) as any; if (titleProp?.title?.[0]?.plain_text) { titleText = titleProp.title[0].plain_text; } } return { content: [{ type: "text", text: `# ${titleText}\n\n${content}` }] }; } catch (error: any) { return { content: [{ type: "text", text: `Error retrieving page: ${error.message}` }], isError: true }; } } - src/index.ts:95-161 (registration)Registration of the 'get-page' tool using server.tool, specifying the name, input schema { pageId: z.string() }, and the handler function.
server.tool( "get-page", { pageId: z.string() }, async ({ pageId }) => { try { // Get the page const page = await notion.pages.retrieve({ page_id: pageId }); // Get page blocks (content) const blocks = await notion.blocks.children.list({ block_id: pageId }); // Extract text from blocks const content = blocks.results.map((block: any) => { if (block.type === 'paragraph') { return block.paragraph.rich_text.map((text: any) => text.plain_text).join(''); } if (block.type === 'heading_1') { return `# ${block.heading_1.rich_text.map((text: any) => text.plain_text).join('')}`; } if (block.type === 'heading_2') { return `## ${block.heading_2.rich_text.map((text: any) => text.plain_text).join('')}`; } if (block.type === 'heading_3') { return `### ${block.heading_3.rich_text.map((text: any) => text.plain_text).join('')}`; } if (block.type === 'bulleted_list_item') { return `• ${block.bulleted_list_item.rich_text.map((text: any) => text.plain_text).join('')}`; } if (block.type === 'numbered_list_item') { return `1. ${block.numbered_list_item.rich_text.map((text: any) => text.plain_text).join('')}`; } return ''; }).filter(Boolean).join('\n\n'); // Safely extract title from page let titleText = 'Untitled'; // Type assertion to access properties as any const pageAny = page as any; if (pageAny.properties) { // Find the first property that's a title const titleProp = Object.values(pageAny.properties).find( (prop: any) => prop.type === 'title' ) as any; if (titleProp?.title?.[0]?.plain_text) { titleText = titleProp.title[0].plain_text; } } return { content: [{ type: "text", text: `# ${titleText}\n\n${content}` }] }; } catch (error: any) { return { content: [{ type: "text", text: `Error retrieving page: ${error.message}` }], isError: true }; } } ); - src/index.ts:97-97 (schema)Input schema for the tool: requires a 'pageId' string parameter.
{ pageId: z.string() },