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.