AI Plugin Index
notion-mcp
CommunityMCP server by shck-dev · updated · ★ 2 · 40 downloads a week
Notion MCP server — search, export, and import pages as markdown notion-mcp is a community project by shck-dev, not verified by a company domain.
Last commit 120 days ago
MIT: permissive, fine for commercial use
Clear description, published package or server URL, original repository
Not checked yet. What we check
What you need
| Setting | Needed | What it is |
|---|---|---|
NOTION_TOKENEnvironment variable, secret | Required | Notion token_v2 cookie value from browser DevTools |
NOTION_USER_IDEnvironment variable | Required | Notion user ID from x-notion-active-user-header |
NOTION_SPACE_IDEnvironment variable | Required | Notion workspace ID from API request body |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
Install notion-mcp
Built from the published package, never by AIclaude mcp add notion-mcp -e NOTION_TOKEN=YOUR_NOTION_TOKEN -e NOTION_USER_ID=YOUR_NOTION_USER_ID -e NOTION_SPACE_ID=YOUR_NOTION_SPACE_ID -- npx -y @shck-dev/notion-mcpRun in your terminal. Add --scope user to use it in every project.
{
"mcpServers": {
"notion-mcp": {
"command": "npx",
"args": [
"-y",
"@shck-dev/notion-mcp"
],
"env": {
"NOTION_TOKEN": "YOUR_NOTION_TOKEN",
"NOTION_USER_ID": "YOUR_NOTION_USER_ID",
"NOTION_SPACE_ID": "YOUR_NOTION_SPACE_ID"
}
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
{
"mcpServers": {
"notion-mcp": {
"command": "npx",
"args": [
"-y",
"@shck-dev/notion-mcp"
],
"env": {
"NOTION_TOKEN": "YOUR_NOTION_TOKEN",
"NOTION_USER_ID": "YOUR_NOTION_USER_ID",
"NOTION_SPACE_ID": "YOUR_NOTION_SPACE_ID"
}
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"notion-mcp": {
"command": "npx",
"args": [
"-y",
"@shck-dev/notion-mcp"
],
"env": {
"NOTION_TOKEN": "YOUR_NOTION_TOKEN",
"NOTION_USER_ID": "YOUR_NOTION_USER_ID",
"NOTION_SPACE_ID": "YOUR_NOTION_SPACE_ID"
}
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add notion-mcp --env NOTION_TOKEN=YOUR_NOTION_TOKEN --env NOTION_USER_ID=YOUR_NOTION_USER_ID --env NOTION_SPACE_ID=YOUR_NOTION_SPACE_ID -- npx -y @shck-dev/notion-mcp{
"mcpServers": {
"notion-mcp": {
"command": "npx",
"args": [
"-y",
"@shck-dev/notion-mcp"
],
"env": {
"NOTION_TOKEN": "YOUR_NOTION_TOKEN",
"NOTION_USER_ID": "YOUR_NOTION_USER_ID",
"NOTION_SPACE_ID": "YOUR_NOTION_SPACE_ID"
}
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
gemini mcp add notion-mcp npx -y @shck-dev/notion-mcpGemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.
MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the notion-mcp block.
Alternatives to notion-mcp
All alternatives →
Connect AI agents to Exa for web search, content fetching, and multi-step research.
Search and discover Agent Skills from the skills.sh registry. Powered by HAPI MCP server.
Visit https://brave.com/search/api/ for a free API key. Search the web, local businesses, images,…
Connect to Atlassian Jira, Confluence, Loom, and more to search, create, and manage your work.
Search, read, annotate, and add to your Zotero research library, local or web.
Digital asset manager - upload, organize, search, and generate on-brand images and videos
notion-mcp: common questions
How do I install notion-mcp?
In Claude Code run claude mcp add notion-mcp -e NOTION_TOKEN=YOUR_NOTION_TOKEN -e NOTION_USER_ID=YOUR_NOTION_USER_ID -e NOTION_SPACE_ID=YOUR_NOTION_SPACE_ID -- npx -y @shck-dev/notion-mcp. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is notion-mcp the official server?
notion-mcp is a community project by shck-dev, not verified by a company domain.
Is notion-mcp free?
The code is published under the MIT licence. The service it connects to may have its own pricing.
Is notion-mcp safe to use?
It scores 57 of 100. Grades: maintenance C, licence A, quality C. The security check has not run for it yet. Review the code before you install. How grades work.
What are alternatives to notion-mcp?
Similar MCP servers: exa, Agent Skills Search Server, brave, Atlassian Rovo MCP Server.
Does notion-mcp work with ChatGPT?
Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.