Notion / warm

Append Blocks

Append block children to an existing page or block. Use this to add paragraphs, headings, lists, code blocks, etc. to a page body.

Quick Start

aweb inspect notion.append_blocks
aweb add notion
aweb plan "use Notion append blocks in an agent workflow"

import Aweb, { Agent } from '@aweb/sdk';

const aweb = new Aweb({ apiKey: process.env.AWEB_API_KEY });
const agent = new Agent({ tools: aweb.tools });

agent.add('notion');

const plan = await agent.plan('Use Notion for this workflow');
const tool = await aweb.tools.inspect('notion.append_blocks');

console.log(plan.nextAction);
console.log(tool.inputSchema);

Tool Card

Tool idnotion.append_blocks

ProviderNotion (notion)

Tool nameappend_blocks

Activationwarm

Healthhealthy

Trust score1.00

Transportstreamable_http

Latencynot yet measured

Cost0

Requirements and Governance

Authoauth_2_1_pkce

Credentialsetup_required

Workspacerequired

Approvalnone

RiskREAD

Permissionsread_content, update_content, insert_content, read

Credential setup/api/mcp-warehouse/credentials/notion/init

Schemas

{
  "type": "object",
  "properties": {
    "block_id": {
      "type": "string",
      "description": "Parent block id (page id is also a block id)"
    },
    "children": {
      "type": "array",
      "description": "Notion block objects to append (max 100 per call)"
    },
    "after": {
      "type": "string",
      "description": "Optional sibling id to insert after; default: append at end"
    }
  },
  "required": [
    "block_id",
    "children"
  ],
  "additionalProperties": false
}

Examples

[
  {
    "objective": "Use Notion append blocks in an agent workflow.",
    "args": {
      "block_id": "<block_id>",
      "children": "<children>",
      "after": "<after>"
    }
  }
]

Back to MCP Tool Cards