Notion MCP Server

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() },