Provides tools for creating, retrieving, and updating Notion pages, including managing page properties, metadata, icons, covers, and archive status within Notion databases and workspaces.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Notion MCP Servercreate a new page in my tasks database with title 'Weekly Review' and status 'In Progress'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Notion MCP Server
A Model Context Protocol server for Notion API integration, providing tools to create, retrieve, and update Notion pages.
Features
Create Page: Create new pages in databases or as child pages
Retrieve Page: Get page properties and metadata
Update Page: Modify page properties, icons, covers, and archive status
Retrieve Page Property: Get detailed property information with pagination support
Related MCP server: Notion MCP Server
Installation
Configuration
Create a .env file with your Notion API key:
Getting a Notion API Key
Go to Notion Developers
Create a new integration
Copy the "Internal Integration Token"
Share your databases/pages with the integration
Usage
STDIO Transport (Development)
HTTP Transport (Production)
Available Tools
notion_create_page
Creates a new page in Notion.
Parameters:
parent(required): Parent page or database IDproperties(required): Page properties matching parent schemachildren(optional): Page content as block objectsicon(optional): Page icon (emoji or external URL)cover(optional): Page cover image
Example:
notion_retrieve_page
Retrieves a Notion page by ID.
Parameters:
page_id(required): The page ID to retrievefilter_properties(optional): Specific property IDs to return
notion_update_page
Updates page properties and metadata.
Parameters:
page_id(required): The page ID to updateproperties(optional): Properties to updatein_trash(optional): Archive/restore the pageicon(optional): Update page iconcover(optional): Update page cover
notion_retrieve_page_property
Retrieves detailed property information with pagination.
Parameters:
page_id(required): The page IDproperty_id(required): The property IDpage_size(optional): Number of items per page (max 100)start_cursor(optional): Pagination cursor
Building
Development
Client Configuration
For HTTP transport, add to your MCP client config:
For STDIO transport:
Health Check
When running HTTP transport:
Error Handling
The server provides detailed error messages for:
Missing API keys
Invalid page/database IDs
Permission errors
Malformed requests
Notion API rate limits
License
MIT