setup-notion

Skill: Setup Notion

Purpose

Guided Notion MCP setup wizard. Configures the hosted Notion MCP server, walks the user through OAuth authentication, and verifies the connection by searching their workspace.

When to Use

• User says /setup-notion, "connect to notion", "set up notion", "I want to export to Notion"
• Routed here from /connect-data or /export notion when Notion MCP is not configured

Invocation

/setup-notion — start the setup wizard

Instructions

Step 1: Check Existing Configuration

1a. Check .mcp.json for Notion server: Read .mcp.json (if it exists) and look for a notion server entry.

1b. Check if Notion MCP tools are available: Try to call mcp__notion__notion-search with a test query.

Decision matrix:

• Notion MCP configured + tools available → skip to Step 4 (verify)
• Notion MCP configured + tools NOT available → go to Step 3 (restart needed)
• No Notion config at all → continue to Step 2

Step 2: Add Notion to .mcp.json

1. Read .mcp.json if it exists (preserve other servers like Snowflake, Slack)
2. Add the notion server entry:

   {
     "notion": {
       "type": "http",
       "url": "https://mcp.notion.com/mcp"
     }
   }
   

3. Write the updated .mcp.json using the Edit tool (or Write if creating fresh)

That's it — no API key, no npm package, no credentials. Notion's hosted MCP server handles authentication via OAuth when the user runs /mcp.

Tell the user:

• "Notion MCP server added to your config."
• "This uses Notion's official hosted server with OAuth — no API key needed."

Step 3: Restart & Authenticate

The MCP server won't be available until Claude Code restarts and loads the new .mcp.json config.

Tell the user:

• "Claude Code needs to restart to pick up the new config."
• "After restarting:"
• " 1. Run /mcp in Claude Code"
• " 2. Find notion in the server list and click Authenticate"
• " 3. A browser window will open — sign in to Notion and authorize access"
• " 4. Select which pages/databases to share (or share the whole workspace)"
• " 5. Come back here and run /setup-notion again — I'll verify the connection"