Notion MCP Server

Instructions

Implementation Reference

• server.js:375-397 (handler)

  Handler logic for the 'create-page' tool. Destructures arguments, constructs parameters for Notion's pages.create API (parent database_id, properties, optional children), calls the API, and returns the response as formatted text.

  else if (name === "create-page") {
    const { parent_id, properties, children } = args;
    
    const pageParams = {
      parent: { database_id: parent_id },
      properties,
    };
  
    if (children) {
      pageParams.children = children;
    }
  
    const response = await notion.pages.create(pageParams);
  
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(response, null, 2),
        },
      ],
    };
  }

• server.js:81-102 (registration)

  Registration of the 'create-page' tool in the tools/list response, including name, description, and input schema definition.

  {
    name: "create-page",
    description: "Create a new page in a database",
    inputSchema: {
      type: "object",
      properties: {
        parent_id: {
          type: "string",
          description: "ID of the parent database"
        },
        properties: {
          type: "object",
          description: "Page properties"
        },
        children: {
          type: "array",
          description: "Optional content blocks"
        }
      },
      required: ["parent_id", "properties"]
    }
  },