What is Notion MCP?
Notion MCP is a Model Context Protocol server that connects AI agents to your Notion workspace. Search pages, read page content, create new pages, update database entries, and manage properties — all through structured MCP tool calls. Your AI agent can use Notion as a knowledge base, task manager, or documentation system.
Answer-Ready: Notion MCP connects AI agents to Notion workspaces. Search, read, create, and update pages and databases via MCP tool calls. Use Notion as AI knowledge base or task manager. Official Notion integration. Works with Claude Code and Cursor.
Best for: Teams using Notion as knowledge base who want AI agent access. Works with: Claude Code, Cursor, Claude Desktop. Setup time: Under 5 minutes.
Core Tools
| Tool | What It Does |
|---|---|
| search | Search across all pages and databases |
| get_page | Read page content as markdown |
| create_page | Create a new page with content |
| update_page | Modify page properties |
| query_database | Query a Notion database with filters |
| create_database_item | Add entry to a database |
| update_database_item | Update database entry properties |
| list_databases | List all accessible databases |
Use Cases
| Use Case | How |
|---|---|
| Knowledge Q&A | Search docs → Read pages → Answer questions |
| Task Management | Query task DB → Update status → Create new tasks |
| Meeting Notes | Create page → Add structured notes → Link to project |
| Documentation | Search existing docs → Create new pages → Cross-link |
| Sprint Planning | Query backlog DB → Prioritize → Update assignments |
Setup
1. Create Notion Integration
- Go to notion.so/my-integrations
- Create new integration
- Copy the API key (starts with
ntn_)
2. Share Pages with Integration
In Notion, click "..." on any page → "Connect to" → Select your integration. The MCP can only access pages shared with the integration.
3. Configure MCP
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "@notionhq/notion-mcp-server"],
"env": {
"NOTION_API_KEY": "ntn_your_key_here"
}
}
}
}FAQ
Q: Can the AI edit any page? A: Only pages explicitly shared with the integration. This is Notion's permission model.
Q: Does it support databases? A: Yes, full database support — query with filters, create items, update properties.
Q: Is this the official Notion MCP?
A: Yes, published by Notion under @notionhq/notion-mcp-server.