Get the schema of a Notion database with all property definitions.

Args: database_id: The ID of the Notion database

Returns: Dict with database title and properties schema

Query a Notion database with optional filter and sorts.

Args: database_id: The ID of the Notion database filter: Optional Notion filter object (see Notion API docs) sorts: Optional list of sort objects page_size: Number of results per page (max 100) start_cursor: Cursor for pagination (from previous query's next_cursor) fetch_all: If True, auto-paginate to fetch ALL results. If False, return single page with pagination info. Default True.

Returns: Dict with: - results: List of database rows with parsed properties - total_count: Number of results returned - has_more: Whether more results exist (only when fetch_all=False) - next_cursor: Cursor for next page (only when fetch_all=False and has_more=True)

Create a new row in a Notion database with full property type support.

Args: database_id: The ID of the Notion database properties: Dict of property_name -> value. Supported types: - title: str - rich_text: str - number: int or float - select: str (option name) - multi_select: list[str] (option names) - date: str (ISO 8601) or {"start": str, "end": str} - checkbox: bool - url: str - email: str - phone_number: str - status: str (status name) - files: list[str] (URLs) - relation: list[str] (page IDs) - people: list[str] (user IDs) content: Optional markdown content to add to the page body

Returns: Created page with ID and URL

Update properties on an existing Notion database row.

Args: page_id: The ID of the page/row to update properties: Dict of property_name -> value to update

Returns: Updated page info

Append blocks to a Notion page.

Args: page_id: The ID of the page to append to blocks: List of block objects. Each block should have: - type: Block type (paragraph, heading_1, code, table, etc.) - Additional fields depending on type: - paragraph: {"text": "content"} - heading_1/2/3: {"text": "heading"} - bulleted_list_item: {"text": "item"} - numbered_list_item: {"text": "item"} - to_do: {"text": "task", "checked": false} - code: {"code": "content", "language": "python"} - quote: {"text": "quote"} - callout: {"text": "content", "emoji": "💡"} - divider: {} (no additional fields) - bookmark: {"url": "https://..."} - image: {"url": "https://..."} - table: {"rows": [["a", "b"], ["c", "d"]], "has_column_header": true} after_block_id: Optional block ID to insert after

Returns: List of created blocks

Append markdown content to a Notion page.

Converts markdown to Notion blocks and appends them.

Args: page_id: The ID of the page to append to markdown: Markdown content to append

Returns: Number of blocks created

Get a Notion page with its properties and optionally content.

Args: page_id: The ID of the page include_content: Whether to fetch page content blocks (auto-paginates all blocks)

Returns: Page info with properties and optionally content

Search Notion pages and databases.

Args: query: Search query filter_type: Optional filter - "page" or "database" page_size: Number of results per page (max 100) start_cursor: Cursor for pagination fetch_all: If True, auto-paginate to fetch ALL results. Default True.

Returns: Dict with: - results: List of matching pages/databases - total_count: Number of results - has_more: Whether more results exist (only when fetch_all=False) - next_cursor: Cursor for next page (only when fetch_all=False and has_more=True)

Retrieve a single block by ID.

Args: block_id: The ID of the block

Returns: Block object with type and content

Retrieve children blocks of a block or page.

Args: block_id: The ID of the parent block or page page_size: Number of results per page (max 100) start_cursor: Cursor for pagination fetch_all: If True, auto-paginate all children. Default True.

Returns: Dict with results list and pagination info

Update a block's content or archive it.

Args: block_id: The ID of the block to update fields: Block fields to update. Pass the block type key with its content, e.g. {"paragraph": {"rich_text": [...]}} or {"archived": true} to archive.

Returns: Updated block object

Delete (archive) a block.

Args: block_id: The ID of the block to delete

Returns: Deleted block object

Create a standalone page (not a database row).

For creating database rows, use create_database_row instead.

Args: parent_type: "page_id" or "workspace" (for top-level pages) parent_id: The ID of the parent page (ignored if workspace) title: Page title properties: Optional additional properties content: Optional markdown content for the page body

Returns: Created page with ID and URL

Move a page to a different parent.

Args: page_id: The ID of the page to move parent_type: "page_id" or "database_id" parent_id: The ID of the new parent

Returns: Moved page info

Create a comment on a page or reply to a discussion thread.

Args: page_id: The ID of the page to comment on text: Comment text content discussion_id: Optional discussion thread ID to reply to

Returns: Created comment object

Get the bot user associated with the current token.

Returns: Bot user object with name, type, and workspace info

List all users in the workspace.

Args: page_size: Number of results per page (max 100) start_cursor: Cursor for pagination

Returns: List of user objects

Get a user by ID.

Args: user_id: The ID of the user

Returns: User object

Create a new database (as a child of a page).

Args: parent_page_id: The ID of the parent page title: Database title properties: Database property schema. Keys are property names, values are property config objects, e.g.: {"Name": {"title": {}}, "Tags": {"multi_select": {"options": []}}}

Returns: Created database with ID and URL