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.
Genviral
Genviral is a remote MCP server for creating, managing, scheduling, and publishing social content. Agents can access account context, upload media, manage posts, and generate campaign assets through OAuth-scoped tools with explicit publish confirmation.
Airtable
Read and write data to Airtable bases
Monday.com
Work management and project tracking
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