A Model Context Protocol (MCP) server that provides full access to the Notion API. Search, create, and manage databases, pages, blocks, and users directly from Claude, Cursor, or any MCP-compatible client.
- Search - Full-text search across all pages and databases
- Database Management - Create databases, query with filters and sorts
- Page Management - Create, read, update, and archive pages
- Block Management - Read, append, and delete content blocks
- User Access - List workspace members and get user details
- Built-in Rate Limiting - Automatic throttling (3 req/s) with 429 retry
| Tool | Description |
|---|---|
notion_search |
Search across all pages and databases |
notion_get_database |
Get database schema and details |
notion_query_database |
Query database with filters and sorting |
notion_create_database |
Create a new database in a page |
notion_create_page |
Create a new page in a database or page |
notion_get_page |
Get page properties and metadata |
notion_update_page |
Update page properties or archive |
notion_get_block |
Get a block by ID |
notion_get_block_children |
Get child blocks of a page or block |
notion_append_block_children |
Append content blocks to a page |
notion_delete_block |
Delete (archive) a block |
notion_list_users |
List all workspace users |
notion_get_user |
Get user details by ID |
npx @cloud9-labs/mcp-notion- Node.js >= 20.0.0
- Notion Internal Integration token from My Integrations
- Go to notion.so/my-integrations
- Click "New integration"
- Give it a name and select a workspace
- Copy the Internal Integration Token
- Share target pages/databases with the integration
No installation needed - configure your MCP client to use npx.
npm i -g @cloud9-labs/mcp-notiongit clone https://github.com/cloud9-labs/mcp-notion.git
cd mcp-notion
npm ci
npm run buildAdd to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "@cloud9-labs/mcp-notion"],
"env": {
"NOTION_API_KEY": "ntn_your_integration_token_here"
}
}
}
}Add to .cursor/mcp.json:
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "@cloud9-labs/mcp-notion"],
"env": {
"NOTION_API_KEY": "ntn_your_integration_token_here"
}
}
}
}- "Search for all pages about marketing"
- "Query the Tasks database for items assigned to me"
- "Create a new page in database abc123 with title Meeting Notes"
- "Add a paragraph block to page xyz789"
- "List all users in the workspace"
- "Get the schema of database def456"
This MCP server is part of an open-source toolkit for AI-powered sales automation. We are building MCP servers that connect your entire sales stack.
Follow our progress and get updates:
- X (Twitter): @cloud9_ai_labs
- GitHub: cloud9-labs
MIT