Install this MCP
Pick your client, then copy the config.
{
"mcpServers": {
"notionApi": {
"command": "npx",
"args": [
"-y",
"@notionhq/notion-mcp-server"
],
"env": {
"NOTION_TOKEN": "YOUR_NOTION_TOKEN"
}
}
}
}{
"mcpServers": {
"notionApi": {
"command": "npx",
"args": [
"-y",
"@notionhq/notion-mcp-server"
],
"env": {
"NOTION_TOKEN": "YOUR_NOTION_TOKEN"
}
}
}
}{
"servers": {
"notionApi": {
"command": "npx",
"args": [
"-y",
"@notionhq/notion-mcp-server"
],
"env": {
"NOTION_TOKEN": "YOUR_NOTION_TOKEN"
}
}
}
}{
"mcpServers": {
"notionApi": {
"command": "npx",
"args": [
"-y",
"@notionhq/notion-mcp-server"
],
"env": {
"NOTION_TOKEN": "YOUR_NOTION_TOKEN"
}
}
}
}# Add to ~/.codex/config.toml (or .codex/config.toml in a trusted project) [mcp_servers.notionApi] command = "npx" args = ["-y", "@notionhq/notion-mcp-server"] [mcp_servers.notionApi.env] NOTION_TOKEN = "YOUR_NOTION_TOKEN"
Set up with your agent
Uses the same client as above (Cursor). Paste into that agent.
Install the "Notion MCP" MCP for Cursor in this workspace.
1. Read official install docs: https://github.com/makenotion/notion-mcp-server
2. Merge this JSON into .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):
{
"mcpServers": {
"notionApi": {
"command": "npx",
"args": [
"-y",
"@notionhq/notion-mcp-server"
],
"env": {
"NOTION_TOKEN": "YOUR_NOTION_TOKEN"
}
}
}
}
3. Required environment variables / secrets (ask the user; never invent secrets):
- NOTION_TOKEN (required): Notion integration token (ntn_…).
4. Restart Cursor if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets.
Catalog: https://averlo.xyz/launches/notion.htmlInstall the "Notion MCP" MCP for Claude Desktop in this workspace.
1. Read official install docs: https://github.com/makenotion/notion-mcp-server
2. Merge this JSON into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"notionApi": {
"command": "npx",
"args": [
"-y",
"@notionhq/notion-mcp-server"
],
"env": {
"NOTION_TOKEN": "YOUR_NOTION_TOKEN"
}
}
}
}
3. Required environment variables / secrets (ask the user; never invent secrets):
- NOTION_TOKEN (required): Notion integration token (ntn_…).
4. Restart Claude Desktop if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets.
Catalog: https://averlo.xyz/launches/notion.htmlInstall the "Notion MCP" MCP for VS Code in this workspace.
1. Read official install docs: https://github.com/makenotion/notion-mcp-server
2. Merge this JSON into .vscode/mcp.json:
{
"servers": {
"notionApi": {
"command": "npx",
"args": [
"-y",
"@notionhq/notion-mcp-server"
],
"env": {
"NOTION_TOKEN": "YOUR_NOTION_TOKEN"
}
}
}
}
3. Required environment variables / secrets (ask the user; never invent secrets):
- NOTION_TOKEN (required): Notion integration token (ntn_…).
4. Restart VS Code if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets.
Catalog: https://averlo.xyz/launches/notion.htmlInstall the "Notion MCP" MCP for Windsurf in this workspace.
1. Read official install docs: https://github.com/makenotion/notion-mcp-server
2. Merge this JSON into ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"notionApi": {
"command": "npx",
"args": [
"-y",
"@notionhq/notion-mcp-server"
],
"env": {
"NOTION_TOKEN": "YOUR_NOTION_TOKEN"
}
}
}
}
3. Required environment variables / secrets (ask the user; never invent secrets):
- NOTION_TOKEN (required): Notion integration token (ntn_…).
4. Restart Windsurf if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets.
Catalog: https://averlo.xyz/launches/notion.htmlInstall the "Notion MCP" MCP for Codex in this workspace. 1. Read official install docs: https://github.com/makenotion/notion-mcp-server 2. Merge this TOML under [mcp_servers.*] into ~/.codex/config.toml (or .codex/config.toml in a trusted project): # Add to ~/.codex/config.toml (or .codex/config.toml in a trusted project) [mcp_servers.notionApi] command = "npx" args = ["-y", "@notionhq/notion-mcp-server"] [mcp_servers.notionApi.env] NOTION_TOKEN = "YOUR_NOTION_TOKEN" 3. Required environment variables / secrets (ask the user; never invent secrets): - NOTION_TOKEN (required): Notion integration token (ntn_…). 4. Restart Codex if needed, then run a smoke test (list tools or one safe call). Confirm with the user before writing secrets. Catalog: https://averlo.xyz/launches/notion.html
Try it
After install, paste one of these into your agent.
- Read and write Notion pages from AI
- Search Notion workspace content
- Manage databases and tables

