Set up Notion MCP in Claude Code
Access and manage Notion pages, databases, and blocks. Create content, query databases, and organize your workspace from your AI editor.
1
Locate the config file
Claude Code reads MCP server configuration from the following file:
~/.claude.jsonCreate this file if it does not already exist.
2
Add the configuration
You can configure Notion MCP using the CLI command or by editing the config file directly.
Option A: CLI command
bash
claude mcp add notion-mcp -e NOTION_API_KEY=YOUR_NOTION_API_KEY -- npx -y notion-mcp-serverOption B: Config file
json
{
"mcpServers": {
"notion-mcp": {
"command": "npx",
"args": [
"-y",
"notion-mcp-server"
],
"env": {
"NOTION_API_KEY": "YOUR_NOTION_API_KEY"
}
}
}
}3
Set up environment variables
Notion MCP requires the following environment variables:
NOTION_API_KEYRequiredNotion integration API key
4
Verify it works
Restart Claude Code. Notion MCP should appear in your MCP server list with 10 tools available.
This server adds approximately 5,150 tokens to your context window for tool definitions.