Notion

• Notion Append Blocks — Append content to a Notion page or block. You can provide either: - **markdown_content**: A Markdown string that is automatically converted to Notion blocks - **children**: Raw Notion block objects for full control <example description="Add content using Markdown (recommended)"> {"block_id": "page-uuid", "markdown_content": "## New Section\nSection content here.\n\n- Bullet point one\n- Bullet point two"} </example> <example description="Add a to-do list using Markdown"> {"block_id": "page-uuid
• Notion Create Comment — Create a comment on a Notion page or reply to an existing discussion thread. Provide either parent.page_id for a new top-level comment, or discussion_id to reply to an existing thread.
• Notion Create Database — Create a new Notion database as a child of a page. Define the schema via the properties parameter. Each property needs a name (key) and type definition (e.g. {'Name': {'title': {}}, 'Status': {'select': {'options': [{'name': 'Done'}]}}}).
• Notion Create Page — Create a new Notion page. Set parent to a database_id to create a database row, or to a page_id to create a child page. Properties must match the parent database schema when creating in a database. For page content, you can provide either: - **markdown_content**: A Markdown string that is automatically converted to Notion blocks (supports headings, lists, to-dos, code blocks, quotes, images, inline formatting) - **children**: Raw Notion block objects for full control over block structure <exam
• Notion Delete Block — Delete a Notion block by archiving it. This is equivalent to setting archived=true on the block.
• Notion Get Block Children — Retrieve the child blocks (content) of a page or block. This is how you read the actual content of a Notion page — the page endpoint only returns properties. Blocks can be nested, so you may need to recursively fetch children of child blocks.
• Notion Get Comments — Retrieve comments from a Notion page or block. Returns threaded discussion comments with pagination support.
• Notion Get Database — Retrieve a Notion database by its ID, including its schema (property definitions), title, and description.
• Notion Get Page — Retrieve a Notion page by its ID, including all of its property values.
• Notion Get Self — Get information about the authenticated Notion integration bot user, including workspace details.
• Notion Get User — Get details for a specific Notion user by their user ID.
• Notion Import File — Import a file from a public URL into Notion's permanent storage. Notion downloads the file server-side — no binary upload needed. Supports images, PDFs, videos, and other file types. If attach_to_page_id is provided, the file is automatically added as a block on that page. <example description="Import an image and attach to a page"> {"url": "https://example.com/photo.png", "filename": "team-photo.png", "attach_to_page_id": "page-uuid"} </example> <example description="Import a PDF without attac
• Notion List Users — List all users (people and bots) in the Notion workspace. Supports pagination.
• Notion Move Page — Move a Notion page to a different parent. The page can be moved under another page or into a database. The bot must have edit access to both the page and the new parent. <example description="Move a page under another page"> {"page_id": "page-uuid", "new_parent_type": "page_id", "new_parent_id": "parent-page-uuid"} </example> <example description="Move a page into a database"> {"page_id": "page-uuid", "new_parent_type": "page_id", "new_parent_id": "database-uuid"} </example>
• Notion Query Database — Query a Notion database to retrieve pages (rows) matching filter conditions. Supports compound filters (and/or), property-based sorting, and pagination. Fetch the database schema first to see available properties and types before building filters. <example description="Filter by select property"> {"database_id": "uuid", "filter": {"property": "Status", "select": {"equals": "Done"}}} </example> <example description="Sort by date descending"> {"database_id": "uuid", "sorts": [{"property": "Due Da
• Notion Read Page — Read a Notion page and return its content as readable Markdown. Combines page properties with the full page content (blocks) rendered as Markdown text. This is the best way to read a Notion page — use the page metadata fetch for raw property JSON or the block-children listing for raw block JSON only when you need the exact API structures. <example description="Read a page by ID"> {"page_id": "56d9f991-dae1-4590-a8c3-6e221943fbb5"} </example> <example description="Read with limited depth"> {"pag
• Notion Search — Search across all pages and databases shared with the integration by title. Optionally filter to only pages or only databases. Results are sorted by last edited time by default. <example description="Search pages by title"> {"query": "Meeting Notes", "filter_type": "page"} </example> <example description="List recent databases"> {"query": "", "filter_type": "database", "page_size": 10} </example> <example description="Browse all recent content"> {"query": "", "page_size": 20} </example>
• Notion Update Block — Update the content of an existing block. Provide the block's type and the updated content. For example, to update a paragraph: {'paragraph': {'rich_text': [{'type': 'text', 'text': {'content': 'New text'}}]}}. Set archived=true to delete the block.
• Notion Update Database — Update a Notion database's title, description, or property schema. Add new properties by including them in the properties object. Rename properties by setting 'name' on an existing property key.
• Notion Update Page — Update a Notion page's properties, icon, or cover. Set archived=true to move the page to trash.

Schemas and invoke metadata: Directory API