TL;DR
Notion is a Productivity MCP server that lets Claude Code, Cursor, Windsurf and any MCP-compatible AI agent pages, databases, search in Notion workspace. Install in 1 minute with mcpizy install notion.
Notion
Install verified 6 toolsProductivity
Pages, databases, search in Notion workspace
Official homepageRepo audit: 90/100 β actively maintained, documented and licensed
Scored on licence, adoption, maintenance and documentation of makenotion/notion-mcp-server. We show the grade whether it flatters the server or not.
last commit 29 days ago Β· 4,600 stars Β· MIT licence Β· 187 open issues
Read the full audit on CheckMCPInstall Notion
mcpizy install notionnpx -y @notionhq/notion-mcp-serverTools exposed
6 tools availablesearchSearch pages and databases across the workspace
searchSearch pages and databases across the workspace
Inputs
querystringrequired
fetchFetch the full content of a page or database by ID
fetchFetch the full content of a page or database by ID
Inputs
idstringrequired
create_pagesCreate one or more pages in a database or under a parent
create_pagesCreate one or more pages in a database or under a parent
Inputs
parentobjectrequiredpagesobject[]required
update_pageUpdate a page's properties or content
update_pageUpdate a page's properties or content
Inputs
page_idstringrequiredpropertiesobjectoptional
create_databaseCreate a new database with a schema
create_databaseCreate a new database with a schema
Inputs
parentobjectrequiredtitlestringrequiredpropertiesobjectrequired
create_commentAdd a comment to a page
create_commentAdd a comment to a page
Inputs
page_idstringrequiredtextstringrequired
Configuration
Works identically across clients. Only the config file path differs.
Claude Code~/.claude.json
~/.claude.json{
"mcpServers": {
"notion": {
"command": "npx",
"args": [
"-y",
"@notionhq/notion-mcp-server"
],
"env": {
"NOTION_API_KEY": "ntn_..."
}
}
}
}Cursor.cursor/mcp.json
.cursor/mcp.json{
"mcpServers": {
"notion": {
"command": "npx",
"args": [
"-y",
"@notionhq/notion-mcp-server"
],
"env": {
"NOTION_API_KEY": "ntn_..."
}
}
}
}Windsurf~/.codeium/windsurf/mcp_config.json
~/.codeium/windsurf/mcp_config.json{
"mcpServers": {
"notion": {
"command": "npx",
"args": [
"-y",
"@notionhq/notion-mcp-server"
],
"env": {
"NOTION_API_KEY": "ntn_..."
}
}
}
}Authentication setup
- 1
Create an integration and copy the internal integration secret
Get itNOTION_API_KEY - 2
Share the pages or databases you want accessible with the integration
What you can do with Notion MCP
Paste any of these prompts into Claude Code, Cursor or another MCP-compatible client.
βSearch my Notion for pages mentioning 'Q2 roadmap' and summarise themβ
Uses: search, fetch
βCreate a new page in my Tasks database titled 'Review PR #42'β
Uses: create_pages
βAdd the latest meeting notes to my Engineering workspaceβ
Uses: create_pages
βUpdate page abc123 and mark its Status as Doneβ
Uses: update_page
Works with
More Productivity MCPs
Alternatives to Notion
If Notion doesn't fit your stack, these Productivity MCP servers solve similar problems.
Frequently asked questions
What is the Notion MCP server?
Notion is listed as an Productivity Model Context Protocol server whose documented purpose is to let an MCP-compatible agent pages, databases, search in Notion workspace. Client support, permissions and authentication remain specific to the upstream project.
How do I install Notion MCP with Claude Code?
The fastest way is the MCPizy CLI: run `mcpizy install notion` and MCPizy will add the server to your `.claude.json` automatically. You can also install it manually by adding an entry under `mcpServers` in `.claude.json` with the command `npx -y @notionhq/notion-mcp-server` and restarting Claude Code.
Does MCPizy charge to view or install Notion MCP?
No. Reading this profile and copying its install guidance is free. Upstream software, API, account or usage costs are separate, and licence coverage should be checked from the linked source when available.
Does Notion MCP work with Cursor and Windsurf?
The MCP standard is supported by those clients, but a specific server can still have client-specific setup or transport limits. Use the configuration shown on this page when present and verify the upstream instructions before installation.
What can I do with Notion MCP?
Its documented purpose is to let an MCP-compatible agent pages, databases, search in Notion workspace. The exact tools, permissions and write capabilities depend on the server version and configuration shown by the upstream project.
Compare before you commit
Put this server beside an alternative, or return to the full evidence directory.
Compare MCP serversBack to directory