Notion MCP Server

Implementation Reference

• src/lib/mcp-server.ts:674-713 (handler)

  The main handler function for the MCP 'create-comment' tool. Formats user inputs into Notion API payload and delegates to notionService.createComment, handling response and errors appropriately.

  async ({ page_id, text, discussion_id }) => {
    try {
      const result = await this.notionService.createComment({
        parent: {
          page_id: page_id,
        },
        rich_text: [
          {
            type: "text",
            text: {
              content: text,
            },
          },
        ],
        discussion_id,
      });
  
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify(result, null, 2),
          },
        ],
      };
    } catch (error) {
      console.error("Error in create-comment tool:", error);
      return {
        content: [
          {
            type: "text",
            text: `Error: Failed to create comment - ${
              (error as Error).message
            }`,
          },
        ],
        isError: true,
      };
    }
  }

• src/lib/mcp-server.ts:666-673 (schema)

  Input schema (Zod) for the 'create-comment' tool, validating page_id, text, and optional discussion_id.

  {
    page_id: z.string().describe("The ID of the page to comment on"),
    text: z.string().describe("The comment text content"),
    discussion_id: z
      .string()
      .optional()
      .describe("Optional discussion ID for threaded comments"),
  },

• src/lib/mcp-server.ts:664-714 (registration)

  Registers the 'create-comment' tool with the MCP server inside the registerCommentTools method, providing name, input schema, and handler.

  this.server.tool(
    "create-comment",
    {
      page_id: z.string().describe("The ID of the page to comment on"),
      text: z.string().describe("The comment text content"),
      discussion_id: z
        .string()
        .optional()
        .describe("Optional discussion ID for threaded comments"),
    },
    async ({ page_id, text, discussion_id }) => {
      try {
        const result = await this.notionService.createComment({
          parent: {
            page_id: page_id,
          },
          rich_text: [
            {
              type: "text",
              text: {
                content: text,
              },
            },
          ],
          discussion_id,
        });
  
        return {
          content: [
            {
              type: "text",
              text: JSON.stringify(result, null, 2),
            },
          ],
        };
      } catch (error) {
        console.error("Error in create-comment tool:", error);
        return {
          content: [
            {
              type: "text",
              text: `Error: Failed to create comment - ${
                (error as Error).message
              }`,
            },
          ],
          isError: true,
        };
      }
    }
  );

• src/lib/notion.ts:316-322 (helper)

  Helper method in NotionService that performs the actual Notion API call to create a comment using the SDK client.

  async createComment(params: CreateComment) {
    try {
      return await this.client.comments.create(params);
    } catch (error) {
      this.handleError(error);
    }
  }

• src/types/notion.ts:88-129 (schema)

  Detailed Zod schema and TypeScript type for Notion's CreateComment API parameters, used internally by the handler.

  export const CreateCommentSchema = z.object({
    parent: z.object({
      page_id: z.string(),
    }),
    rich_text: z.array(
      z.object({
        type: z.literal("text"),
        text: z.object({
          content: z.string(),
          link: z
            .object({
              url: z.string(),
            })
            .optional(),
        }),
        annotations: z
          .object({
            bold: z.boolean().optional(),
            italic: z.boolean().optional(),
            strikethrough: z.boolean().optional(),
            underline: z.boolean().optional(),
            code: z.boolean().optional(),
            color: z
              .enum([
                "default",
                "gray",
                "brown",
                "orange",
                "yellow",
                "green",
                "blue",
                "purple",
                "pink",
                "red",
              ])
              .optional(),
          })
          .optional(),
      })
    ),
    discussion_id: z.string().optional(),
  });