Notion Integration

The Notion node lets your agents create and update pages, query databases, manage blocks, and upload files.

Connection Setup

Standard OAuth. During authorization, you choose which pages and databases the integration can access.

Note

Notion’s OAuth scoping is page-level — if an action can’t find a page or database, make sure it was shared with the integration during the connection flow.

Available Tools

Pages

Tool	Description
search-notion	Search pages and databases by title or content
create-a-page	Create a new page with optional parent and properties
retrieve-a-page	Get metadata and content from a page
update-a-page	Modify page properties and content
move-page	Move a page to a different parent
append-a-block	Add content blocks to a page
retrieve-a-block	Get details about a specific content block

Databases

Tool	Description
retrieve-a-database	Get database metadata
retrieve-a-data-source	Get schema and properties for a data source
query-data-source	Query a data source with filters and sorts
create-a-data-source	Create a new data source
update-a-data-source	Update data source properties
list-data-source-templates	List available templates

Comments

Tool	Description
create-a-comment	Add a comment to a page
retrieve-comments	Fetch comments from a page

MCP Server

Server URL	https://mcp.notion.com/mcp
Transport	Streamable HTTP
Docs	Notion MCP Guide

Tips

• Query Data Source supports Notion filter syntax — your agent can build complex queries with AND/OR conditions.
• To add content to an existing page, use Append Block to Parent — Update Page only changes property values, not page content.
• Retrieve Page Content can return markdown, which is often easier for agents to work with than raw block objects.