MCP Server for Notion API. AI agents can search, create, and manage pages, databases, blocks, and comments. 20 operations with full CRUD. Supports pagination and batch queries.
Text to search for in page titles and content (for 'search' operation)
Search/Query Filter
filterstringOptional
Filter object for search or database query (JSON format). For search: {"property":"object","value":"page"} or {"property":"object","value":"database"}. For database queries: complex filter objects.
Sort Configuration
sortsstringOptional
Sort configuration for database queries (JSON array format). Example: [{"property":"Name","direction":"ascending"}]
Page ID
pageIdstringOptional
The ID of the page (for page operations). Can be UUID format or page URL.
Database ID
databaseIdstringOptional
The ID of the database (for database operations). Can be UUID format or database URL.
Block ID
blockIdstringOptional
The ID of the block (for block operations)
User ID
userIdstringOptional
The ID of the user (for user operations)
Comment ID
commentIdstringOptional
The ID of the comment (for comment operations)
Property ID
propertyIdstringOptional
The ID of the property to retrieve (for get_page_property operation)
Parent Page ID
parentPageIdstringOptional
The ID of the parent page when creating a new page (for create_page operation)
Parent Database ID
parentDatabaseIdstringOptional
The ID of the parent database when creating a page in a database (for create_page operation)
Page/Database Title
titlestringOptional
Title for new page or database (for create_page, create_database operations)
Properties
propertiesstringOptional
Properties object for page/database creation or update (JSON format)
Block Children
childrenstringOptional
Array of block objects to add as children (JSON format). Used for create_page and append_block_children.
Icon
iconstringOptional
Icon object for page/database (JSON format). Example: {"type":"emoji","emoji":"🚀"}
Cover
coverstringOptional
Cover object for page/database (JSON format). Example: {"type":"external","external":{"url":"https://..."}}
Archived
archivedbooleanOptional
Set to true to archive a page/block (for update operations)
Default value of this property is false
Rich Text Content
richTextstringOptional
Rich text array for block content or comments (JSON format)
Discussion ID
discussionIdstringOptional
The ID of the discussion thread to add a comment to (for create_comment in existing thread)
Start Cursor
startCursorstringOptional
Pagination cursor for fetching next page of results
Page Size
pageSizeintegerOptional
Number of results to return per page (max 100)
Default value of this property is 100
Persist Results
persistResultsbooleanOptional
Save operation results to dataset for later retrieval