notion-mcp-server
CommunityMCP server by awkoy · updated · ★ 177 · 1.4k downloads a week
Token-auth Notion MCP: pages, databases, blocks, comments, files. Runs headless in CI and agents. notion-mcp-server is a community project by awkoy, not verified by a company domain.
Last commit in the past day
MIT: permissive, fine for commercial use
Clear description, published package or server URL, 177 stars, original repository
Not checked yet. What we check
Install notion-mcp-server
Built from the published package, never by AIclaude mcp add notion-mcp-server -- npx -y notion-mcp-serverRun in your terminal. Add --scope user to use it in every project.
{
"mcpServers": {
"notion-mcp-server": {
"command": "npx",
"args": [
"-y",
"notion-mcp-server"
]
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
{
"mcpServers": {
"notion-mcp-server": {
"command": "npx",
"args": [
"-y",
"notion-mcp-server"
]
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"notion-mcp-server": {
"command": "npx",
"args": [
"-y",
"notion-mcp-server"
]
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add notion-mcp-server -- npx -y notion-mcp-server{
"mcpServers": {
"notion-mcp-server": {
"command": "npx",
"args": [
"-y",
"notion-mcp-server"
]
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
gemini mcp add notion-mcp-server npx -y notion-mcp-serverGemini 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-server block.
Alternatives to notion-mcp-server
All alternatives →Control a real Chrome browser to complete any task: fill forms, extract data, book flights.
Let your AI agent operate any website through a real, logged-in browser session.
Autonomous coding agent CLI - capable of creating/editing files, running commands, using the browser, and more
Web scraping with stealth HTTP, real browsers, and Cloudflare bypass. CSS selectors supported.
Dark web OSINT over Tor: search onion engines, scrape pages, report with your own model.
Firecrawl, the context API for AI agents: search, scrape, interact with the web, plus paper search.
notion-mcp-server: common questions
How do I install notion-mcp-server?
In Claude Code run claude mcp add notion-mcp-server -- npx -y notion-mcp-server. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is notion-mcp-server the official server?
notion-mcp-server is a community project by awkoy, not verified by a company domain.
Is notion-mcp-server free?
The code is published under the MIT licence. The service it connects to may have its own pricing.
Is notion-mcp-server safe to use?
It scores 82 of 100. Grades: maintenance A, licence A, quality B. The security check has not run for it yet. Review the code before you install. How grades work.
What are alternatives to notion-mcp-server?
Similar MCP servers: browser-use, Actionbook, Cline, Scrapling MCP Server.
Does notion-mcp-server 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.
