Overview
Notion MCP Server is a Node-based Model Context Protocol (MCP) server that connects AI assistants like Claude to your Notion workspace, enabling them to interact with your Notion databases, pages, and blocks.
To use Notion MCP Server, set up the server by following the installation guide, obtain your Notion API key, and configure the server to connect with your Notion workspace and AI assistant.
- Connects AI assistants to Notion workspaces - Allows viewing and searching of Notion databases - Enables creation and updating of pages and content blocks - Provides various tools for AI interactions with Notion
- Automating task management in Notion using AI.
- Querying and updating Notion databases through voice commands.
- Enhancing productivity by integrating AI with Notion for content management.
Add to your AI client
Use these steps to connect Notion MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"notionmcp-sjotie": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-notionmcp-sjotie"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"notionmcp-sjotie": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-notionmcp-sjotie"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"notionmcp-sjotie": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-notionmcp-sjotie"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"notionmcp-sjotie": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-notionmcp-sjotie"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"notionmcp-sjotie": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-notionmcp-sjotie"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"notionmcp-sjotie": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-notionmcp-sjotie"
]
}
}
}FAQ
Can I use Notion MCP Server with any AI assistant?
Yes, it is designed to work with various AI assistants, including Claude.
Is there a cost to use Notion MCP Server?
No, it is open-source and free to use.
What are the prerequisites for setting up the server?
You need Node.js, a Notion account, and the Claude Desktop app if using with Claude.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":1918,"uuid":"4c668bc4-bd96-4555-8b0a-3cfad30d5fd9","name":"notionMCP","title":"Notion MCP Server","description":"Node based Notion MCP server","avatar_url":"https://avatars.githubusercontent.com/u/124035684?v=4","created_at":"2025-03-05T06:05:37.193Z","updated_at":"2025-03-12T10:21:43.799Z","status":"created","author_name":"Sjotie","author_avatar_url":"https://avatars.githubusercontent.com/u/124035684?v=4","tags":"[]","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/Sjotie/notionMCP","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"7\",\"license\":\"\",\"language\":\"JavaScript\",\"is_official\":false,\"latest_commit_time\":\"2025-03-26 10:35:11\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]