Notion MCP Server
Notion MCP Server is an MCP server that adds productivity tools to AI assistants such as Claude Desktop, Claude Code and Cursor. This project implements an MCP server for the Notion API. It has 4,711 GitHub stars, is released under the MIT license and runs locally with npx -y @notionhq/notion-mcp-server.
github.com/makenotion/notion-mcp-server (opens in a new tab)
Data as of from the GitHub API; description from the project's repository. Report an error
- Needs API key
- Productivity
- MIT
- Maintained
Install Notion MCP Server
Generated from the server's published package. Replace your-value with your own values.
Claude Desktop
{
"mcpServers": {
"notion-mcp-server-makenotion": {
"command": "npx",
"args": [
"-y",
"@notionhq/notion-mcp-server"
],
"env": {
"NOTION_TOKEN": "your-value"
}
}
}
}Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.
Claude Code
claude mcp add --env NOTION_TOKEN=your-value --transport stdio notion-mcp-server-makenotion -- npx -y @notionhq/notion-mcp-serverCursor
{
"mcpServers": {
"notion-mcp-server-makenotion": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@notionhq/notion-mcp-server"
],
"env": {
"NOTION_TOKEN": "your-value"
}
}
}
}Project file; use ~/.cursor/mcp.json to enable it in every project.
VS Code
{
"inputs": [
{
"type": "promptString",
"id": "notion_token",
"description": "NOTION_TOKEN",
"password": true
}
],
"servers": {
"notion-mcp-server-makenotion": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@notionhq/notion-mcp-server"
],
"env": {
"NOTION_TOKEN": "${input:notion_token}"
}
}
}
}Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).
Environment variables
Variables the server reads at startup.
| Name | Required | Description |
|---|---|---|
NOTION_TOKENsecret | No | Shown in the README's example configuration. |
About Notion MCP Server
This project implements an MCP server for the Notion API. Version 2.0.0 migrates to the Notion API 2025-09-03 which introduces data sources as the primary abstraction for databases.
Similar MCP servers
More productivity MCP servers
Kaneo
usekaneo/kaneo
Official MCP server for Kaneo: manage tasks, projects, and labels from Claude and other MCP clients.
Active · last commit Nov 15, 2026
OfficialProductivityTypeScriptBasic Memory
basicmachines-co/basic-memory
Local-first knowledge management with bi-directional LLM sync via Markdown files.
Active · last commit Nov 16, 2026
ProductivityPythonWindows MCP
CursorTouch/Windows-MCP
An MCP Server for computer-use in Windows OS.
Active · last commit Nov 16, 2026
ProductivityPythonExcel MCP Server
haris-musa/excel-mcp-server
Create and edit Excel files with AI: charts, PivotTables, formulas.
Active · last commit Nov 15, 2026
ProductivityPythonWarden MCP
icoretech/warden-mcp
🔐 Vaultwarden / Bitwarden MCP server for credential-aware AI agents.
Active · last commit Nov 16, 2026
OfficialProductivityTypeScriptDavinci Resolve MCP
samuelgursky/davinci-resolve-mcp
MCP server integration for DaVinci Resolve Studio.
Active · last commit Nov 14, 2026
ProductivityPython
How do I install the Notion MCP Server MCP server?
Add the command npx -y @notionhq/notion-mcp-server to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.
Is Notion MCP Server free?
The server is open source under the MIT license, so running it is free. It needs credentials (NOTION_TOKEN) for the service it connects to, which may require a paid account.
Is Notion MCP Server actively maintained?
The most recent commit was on Oct 29, 2026. The latest release is v2.1.0, published Jan 31, 2026. appsgit only lists MCP servers with a commit in the last six months.