notion-mcp-server

Instructions

Implementation Reference

• src/tools/updatePage.ts:6-26 (handler)

  The core handler function that executes the archiving of a Notion page using the Notion API by setting the page's archived property to true.

  export async function archivePage(
    params: ArchivePageParams
  ): Promise<CallToolResult> {
    try {
      const response = await notion.pages.update({
        page_id: params.pageId,
        archived: true,
      });
  
      return {
        content: [
          {
            type: "text",
            text: `Page archived successfully: ${response.id}`,
          },
        ],
      };
    } catch (error) {
      return handleNotionError(error);
    }
  }

• src/tools/index.ts:15-20 (registration)

  Registers the 'notion_pages' MCP tool, which dispatches to 'archive_page' action handler among other page operations.

  server.tool(
    "notion_pages",
    "Perform various page operations (create, archive, restore, search, update)",
    PAGES_OPERATION_SCHEMA,
    registerPagesOperationTool
  );

• src/schema/page.ts:92-94 (schema)

  Zod schema definition for the parameters required by the archive_page action: pageId (string).

  export const ARCHIVE_PAGE_SCHEMA = {
    pageId: z.string().describe("The ID of the page to archive"),
  };

• src/tools/pages.ts:16-17 (registration)

  Dispatches the 'archive_page' action call to the archivePage handler function within the notion_pages tool.

  case "archive_page":
    return archivePage(params.payload.params);

• src/schema/page.ts:154-160 (schema)

  Part of the discriminated union schema for PAGES_OPERATION_SCHEMA that defines the 'archive_page' action variant.

    action: z
      .literal("archive_page")
      .describe(
        "Use this action to archive an existing page, making it inactive."
      ),
    params: z.object(ARCHIVE_PAGE_SCHEMA),
  }),