Search, read, create and update Notion pages and databases from an MCP client such as Claude.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add notion-server-v-3 --env NOTION_API_KEY='<NOTION_API_KEY>' -- node /absolute/path/to/notion-server/build/index.js~/.codex/config.toml
[mcp_servers.notion-server-v-3]
command = "node"
args = ["/absolute/path/to/notion-server/build/index.js"]
env = { NOTION_API_KEY = "<NOTION_API_KEY>" }
# codex mcp add notion-server-v-3 --env NOTION_API_KEY='<NOTION_API_KEY>' -- node /absolute/path/to/notion-server/build/index.js~/.cursor/mcp.json
{
"mcpServers": {
"notion-server-v-3": {
"command": "node",
"args": [
"/absolute/path/to/notion-server/build/index.js"
],
"env": {
"NOTION_API_KEY": "<NOTION_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"notion-server-v-3": {
"type": "stdio",
"command": "node",
"args": [
"/absolute/path/to/notion-server/build/index.js"
],
"env": {
"NOTION_API_KEY": "<NOTION_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"notion-server-v-3": {
"command": "node",
"args": [
"/absolute/path/to/notion-server/build/index.js"
],
"env": {
"NOTION_API_KEY": "<NOTION_API_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"notion-server-v-3": {
"command": "node",
"args": [
"/absolute/path/to/notion-server/build/index.js"
],
"env": {
"NOTION_API_KEY": "<NOTION_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"notion-server-v-3": {
"command": "node",
"args": [
"/absolute/path/to/notion-server/build/index.js"
],
"env": {
"NOTION_API_KEY": "<NOTION_API_KEY>"
}
}
}
}Environment variables
NOTION_API_KEY
Replace the placeholders with your own credentials and keep them out of version control.