Notion MCP Server
Provides tools for managing Notion pages, blocks, search, and users, exposing Notion content as resources.
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 search for recent project updates"
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 (MCP) server for Notion integration, providing AI assistants with secure access to Notion workspaces.
Features
Page Management: Create, read, update, and archive Notion pages
Search: Search across your Notion workspace
Block Operations: Append blocks and manage page content
User Management: Access workspace users and permissions
Resource Providers: Expose Notion content as MCP resources
Related MCP server: Notion MCP Server
Setup
Install dependencies:
npm installSet up Notion API:
Go to Notion Developers
Create a new integration
Copy the integration token
Configure environment:
cp .env.example .env # Edit .env with your Notion API keyShare pages with integration:
Go to your Notion pages
Share → Add people → Find your integration → Invite
Usage
Development
npm run devProduction
npm run build
npm startTesting with MCP Inspector
npx @modelcontextprotocol/inspectorTools Available
notion_get_page: Retrieve a page by IDnotion_create_page: Create a new pagenotion_update_page: Update an existing pagenotion_search: Search workspace contentnotion_append_blocks: Add blocks to a pagenotion_get_users: Get workspace usersnotion_archive_page: Archive a page
Resources
notion://pages: Recent pages in workspacenotion://page/{id}: Specific page content
Integration with Claude Desktop
Add to your Claude Desktop configuration:
{
"mcpServers": {
"notion": {
"command": "node",
"args": ["path/to/notion-mcp-server/dist/index.js"],
"env": {
"NOTION_API_KEY": "your_token_here"
}
}
}
}Available Tools
7 toolsnotion_append_blocksC
Append blocks to a page
Inputs: blocks (required), pageId (required).
notion_archive_pageC
Archive a Notion page
Inputs: pageId (required).
notion_create_pageC
Create a new Notion page
Inputs: title (required), content, parentId.
notion_get_pageC
Retrieve a Notion page by ID
Inputs: pageId (required).
notion_get_usersC
Get workspace users
Inputs: no named parameters.
notion_searchC
Search Notion workspace
Inputs: query (required), sort, filter.
notion_update_pageC
Update an existing Notion page
Inputs: pageId (required), title, content.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Most tools have clearly distinct resource/action purposes. The main potential overlap is between notion_append_blocks and notion_update_page, but the descriptions reasonably clarify that one appends content blocks while the other updates page properties.
All tools consistently use the notion_ prefix followed by a readable action-oriented name. The pattern is predictable throughout, with only minor variation in whether a noun follows the verb (e.g., notion_search).
Seven tools is a well-scoped set for a focused Notion integration. Each tool corresponds to a core operation, and the count stays within a manageable range without obvious bloat.
Page lifecycle is mostly covered (create, get, update, archive, append blocks), but the surface lacks database operations, block retrieval/update/delete, and comment handling, which are significant gaps for a general Notion server.
Maintenance
Related MCP Connectors
Governed memory and workspace for any AI: tasks, calendar, mail and pages, with per-action consent.
Connect assistants to your company tools with per-person, per-action grants and a full audit log.
Connect assistants to your workspace knowledge, skills, and work tools.
Web search, data extraction and controlled browser automation for AI assistants via OAuth.
Related MCP Servers
- 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.-
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to interact with Notion workspaces through the Notion API, allowing them to search, read, create, update pages and databases, and manage comments using natural language commands.MIT
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to search, create, and manage Notion workspace content including pages and databases. It supports advanced database querying, page updates, and content organization through natural language conversations.-
- FlicenseNot gradedqualityCmaintenanceEnables AI assistants to search Notion pages, create database entries, and append checklist tasks directly via natural language.-