Skip to content
skillsaggregatorskillsaggregator
Privacy: This guide links directly to Notion's credential pages. We never ask you to enter, store, or transmit any credential through this site. Zero outbound calls to anything but the vendor's docs.

Notion MCP — Auth Setup

Notion uses integration API keys to authenticate requests on behalf of your workspace.

1. Get your credentials

  1. Open the Notion My Integrations page (opens Notion — we never see your key)
  2. Click + New integration and configure the permissions your workflow needs
  3. Copy the Internal Integration Secret shown after saving

2. Set environment variables

macOS / Linux — add to ~/.zshrc or ~/.bashrc:

export NOTION_API_KEY=YOUR_INTEGRATION_SECRET_HERE

Then run source ~/.zshrc (or open a new terminal).

Windows — run in Command Prompt (then restart):

setx NOTION_API_KEY "YOUR_INTEGRATION_SECRET_HERE"

3. Verify

npx claude-skills doctor

You should see ✅ next to the Notion MCP entry. If you see ❌, confirm the key is set: echo $NOTION_API_KEY.

4. Restart Claude Code

Quit and reopen Claude Code (or run /mcp list inside Claude Code to confirm the Notion MCP appears).