Before accessing any Notion tools, connect your Notion account via the App Connection page. Without this, tool calls will fail due to missing authorization.
Notion Tool Categories
Page & Block Management
NOTION_CREATE_NOTION_PAGE– Creates a new page in a Notion workspace.NOTION_ADD_PAGE_CONTENT– Appends a single content block to a Notion page or parent block; call repeatedly to add multiple blocks.NOTION_APPEND_BLOCK_CHILDREN– Appends child blocks to a parent block or page, adding content inside existing structures.NOTION_UPDATE_PAGE– Updates properties, icon, cover, or archive status of a page.NOTION_ARCHIVE_NOTION_PAGE– Archives or unarchives a specified Notion page (moves to/from trash).NOTION_DUPLICATE_PAGE– Duplicates a Notion page with all content under a specified parent or workspace.NOTION_DELETE_BLOCK– Archives a Notion block, page, or database by setting its ‘archived’ property to true.NOTION_FETCH_NOTION_BLOCK– Retrieves a Notion block or page by ID (separate action needed for children).NOTION_FETCH_NOTION_CHILD_BLOCK– Retrieves a paginated list of direct child blocks for a given parent block or page.NOTION_NOTION_UPDATE_BLOCK– Updates an existing block’s text content or type-specific properties.
Database Management
NOTION_CREATE_DATABASE– Creates a new Notion database as a subpage under a specified parent page with defined properties.NOTION_FETCH_DATABASE– Fetches a Notion database’s structural metadata by its database ID.NOTION_QUERY_DATABASE– Queries a Notion database for pages (rows) with sorting and pagination.NOTION_INSERT_ROW_DATABASE– Creates a new page (row) in a specified Notion database.NOTION_FETCH_ROW– Retrieves a database row’s properties and metadata (not the page content blocks).NOTION_UPDATE_ROW_DATABASE– Updates or archives an existing database row (page) using its row ID.NOTION_UPDATE_SCHEMA_DATABASE– Updates a database’s title, description, and/or properties.NOTION_RETRIEVE_DATABASE_PROPERTY– Retrieves details about a single database property by database and property ID.
Comments
NOTION_CREATE_COMMENT– Adds a comment to a Notion page or existing discussion thread (no inline block comments).NOTION_FETCH_COMMENTS– Fetches unresolved comments for a specified block or page.NOTION_RETRIEVE_COMMENT– Retrieves a specific comment by its ID.
User & Workspace
NOTION_GET_ABOUT_ME– Retrieves the user object for the bot linked to the current integration token.NOTION_GET_ABOUT_USER– Retrieves detailed info (name, avatar, email) for a specific Notion user by user ID.NOTION_LIST_USERS– Retrieves a paginated list of users (excluding guests) from the workspace.
Search & Utility
NOTION_FETCH_DATA– Simplifies retrieval of Notion items, abstracting native API complexity.NOTION_GET_PAGE_PROPERTY_ACTION– Retrieves a specific property from a Notion page, with pagination support.NOTION_SEARCH_NOTION_PAGE– Searches pages and databases by title; empty query returns all accessible items.
Usage Notes
- Handle page, block, and database IDs carefully to avoid errors.
- Use append and update tools to automate content creation and editing.
- Combine database, comment, and search tools for advanced Notion workflows.