Notion MCP Server

Instructions

Implementation Reference

• server.js:540-565 (handler)

  The handler function for the 'append-block-children' tool. It processes the input arguments, removes dashes from IDs, constructs parameters, calls the Notion API's notion.blocks.children.append method, and returns the response as JSON text.

  else if (name === "append-block-children") {
    let { block_id, children, after } = args;
    
    // Remove dashes if present in block_id
    block_id = block_id.replace(/-/g, "");
  
    const params = {
      block_id,
      children,
    };
  
    if (after) {
      params.after = after.replace(/-/g, ""); // Ensure after ID is properly formatted
    }
  
    const response = await notion.blocks.children.append(params);
  
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(response, null, 2),
        },
      ],
    };
  }

• server.js:220-241 (schema)

  The schema definition for the 'append-block-children' tool, specifying input parameters: block_id (required), children (required array), and optional after.

  {
    name: "append-block-children",
    description: "Append blocks to a parent block",
    inputSchema: {
      type: "object",
      properties: {
        block_id: {
          type: "string",
          description: "ID of the parent block (page or block)"
        },
        children: {
          type: "array",
          description: "List of block objects to append"
        },
        after: {
          type: "string",
          description: "Optional ID of an existing block to append after"
        }
      },
      required: ["block_id", "children"]
    }
  },