Notion MCP Server
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 "Deploy 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 Server create 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
cd backend/notion-mcp
npm installConfiguration
Create a .env file with your Notion API key:
NOTION_API_KEY=your_notion_integration_token_here
NOTION_VERSION=2022-06-28
PORT=3003Getting 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)
npm run dev:stdioHTTP Transport (Production)
npm run dev:http
# or
npm startAvailable 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:
{
"parent": {
"type": "database_id",
"database_id": "d9824bdc-8445-4327-be8b-5b47500af6ce"
},
"properties": {
"Name": {
"title": [{"text": {"content": "New Page"}}]
}
},
"icon": {
"type": "emoji",
"emoji": "📝"
}
}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
npm run buildDevelopment
npm run watch # Watch mode for TypeScript compilationClient Configuration
For HTTP transport, add to your MCP client config:
{
"mcpServers": {
"notion": {
"url": "http://localhost:3003/mcp"
}
}
}For STDIO transport:
{
"mcpServers": {
"notion": {
"command": "node",
"args": ["./dist/index.js"]
}
}
}Health Check
When running HTTP transport:
curl http://localhost:3003/healthError 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
Available Tools
4 toolsnotion_create_pageB
Creates a new page in Notion. Can be a child of a page or database.
Inputs: parent (required), properties (required), children, cover, +1 more.
notion_retrieve_pageA
Retrieves a Notion page by ID. Returns page properties, not page content.
Inputs: page_id (required), filter_properties.
notion_retrieve_page_propertyB
Retrieves a specific property of a Notion page. Use for properties with more than 25 references.
Inputs: page_id (required), property_id (required), page_size, start_cursor.
notion_update_pageC
Updates properties of a Notion page. Can also update icon, cover, or archive/restore pages.
Inputs: page_id (required), cover, icon, in_trash, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
The tools are mostly distinct, with each handling a specific aspect of page management (create, retrieve, update). However, 'notion_retrieve_page' and 'notion_retrieve_page_property' could cause confusion, as the latter is a specialized case of the former, potentially leading to misselection when an agent needs general page info versus a specific property.
All tool names follow a consistent 'notion_verb_noun' pattern using snake_case, with clear verbs like create, retrieve, and update. This predictability makes it easy for agents to understand and use the toolset without naming conflicts or style mismatches.
With 4 tools, the count is borderline for a Notion integration, as it covers basic CRUD operations but feels thin. A typical Notion server might include additional tools for databases, blocks, or search to provide more comprehensive coverage, making this set somewhat limited in scope.
The toolset covers create, retrieve, and update operations for pages, but has notable gaps. There is no delete tool, and it lacks support for databases, blocks, or search functionalities, which are core to Notion's domain. This incompleteness may require agents to work around missing operations for full lifecycle management.
Maintenance
Related MCP Connectors
Create, search and manage Knowtis collaborative notes from AI assistants.
Notes and actions in one app. Let Claude or ChatGPT read and update them.
Streamline your Attio workflows using natural language to search, create, update, and organize com…
Your second brain: documents, meetings, decisions, tables, agents and connected apps.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Notion workspaces through the Notion API. Provides tools to search, read, create, and update Notion pages and databases with real-time synchronization.5,456 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Notion workspaces through the Notion API. Supports searching, reading, creating pages, and querying databases with filters and sorting capabilities.5,456 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Notion workspaces through the Notion API, allowing users to search, read, comment on, and create pages and databases using natural language commands.265,848 npmMIT
- AlicenseNot gradedqualityNot gradedmaintenanceEnables AI workflows to integrate with Notion workspaces, supporting page and database creation, queries with filters and sorting, content updates, and workspace-wide search operations.-