Notion append blocks

notion__append_blocks

Access

Requires a project integration connection for notion.

Call type: Can change resources.

Arguments

FieldTypeRequiredDescription and constraints
blockIdstringYesPage or block ID to append children to
childrenvalue[]YesNotion block objects to append
afterstringNoOptional existing child block ID after which to append

Example request

Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "notion__append_blocks",
    "arguments": {
      "blockId": "example",
      "children": []
    }
  }
}

Result

No output schema is published for this tool. The input contract does not define its return fields. Inspect the MCP response content and isError; do not assume a fixed object shape. See the notion integration reference for provider setup and tool context.

Full schemas

json
{
  "type": "object",
  "properties": {
    "blockId": {
      "type": "string",
      "description": "Page or block ID to append children to"
    },
    "children": {
      "type": "array",
      "description": "Notion block objects to append"
    },
    "after": {
      "type": "string",
      "description": "Optional existing child block ID after which to append"
    }
  },
  "required": [
    "blockId",
    "children"
  ],
  "description": "Arguments for the notion__append_blocks tool."
}