Notion MCP Server
by Notion
Official Notion MCP server for AI-powered workspace management
productivity Node.js Beginner Self-hostable Docker Verified Featured
⭐ 4k stars 📅 Updated: 1mo ago
Description
Official Notion MCP server that connects AI clients to Notion workspaces. Provides 22 tools for searching content, reading and writing pages, querying data sources, managing databases, comments, and blocks. Supports both STDIO and Streamable HTTP transports, optimized for LLM token consumption. Version 2.0 leverages the Notion API 2025-09-03 with data sources support, enabling AI assistants to fully interact with your Notion workspace — from creating pages and databases to managing comments and reorganizing content structure.
✅ Best for
Teams and developers who want AI assistants to manage their Notion workspace
⏭️ Skip if
You need offline access or real-time collaborative editing via AI
💡 Use cases
- Managing Notion pages, databases, and blocks from AI assistants
- Searching and querying Notion workspaces using natural language
- Automating content creation and organization in Notion
- Building AI workflows that read and write Notion data sources
👍 Pros
- ✓ Official Notion project with full API coverage (22 tools)
- ✓ Dual transport support — STDIO for local, Streamable HTTP for remote
- ✓ Optimized for LLM token consumption, reducing context usage
- ✓ Supports data sources API for structured data queries
👎 Cons
- ✗ Requires a Notion integration token with proper permissions
- ✗ Large workspaces may produce verbose responses that consume context
- ✗ Rate-limited by Notion API quotas on heavy usage
🔧 Exposed tools (10 tools)
| Tool | Category | Description |
|---|---|---|
| manage_comments | collaboration | Create and retrieve comments on pages and blocks |
| move_page | management | Move a page to a different parent location |
| read_page | read | Read the content of a Notion page |
| query_database | read | Query a Notion database with filters and sorting |
| search | search | Search for pages and databases in a Notion workspace |
| update_page | write | Update properties and content of an existing page |
| create_page | write | Create a new page in a Notion workspace |
| create_database | write | Create a new database with defined schema |
| update_database | write | Update database properties and schema |
| append_blocks | write | Append content blocks to a page |
⚡ Installation
Prerequisites:
- • Node.js v18+
- • Notion integration token
- • API key required
Check Claude Code documentation to configure this MCP server.
💡 Tips & tricks
Create a dedicated Notion integration with minimal required permissions. Share only the specific pages and databases the AI needs access to, keeping the scope narrow for both security and performance.
Quick info
- Author
- Notion
- License
- MIT
- Runtime
- Node.js 18+
- Transport
- stdio
- Category
- productivity
- Difficulty
- Beginner
- Self-hostable
- ✅
- Auth
- —
- Docker
- 🐳 Docker available
- Version
- latest
- Updated
- Feb 28, 2026
Client compatibility
- ✅ Claude Code
- ✅ Cursor
- ✅ VS Code Copilot
- ❓ Gemini CLI
- ✅ Windsurf
- ❓ Cline
- ❓ JetBrains AI
- ❓ Warp
Platforms
🍎 macOS 🐧 Linux 🪟 Windows