Skip to content
Free / $10/moUI Design, Docs, Specs & Cloud Deploymcp-stdio๐ŸŽ Free Workspace + Official MCP

Notion Official Workspace, Wiki & Specs MCP for Claude Code, ChatGPT, Gemini CLI & Cursor

Search pages, update PRDs, query Notion databases & sync meeting action items directly from Claude/ChatGPT.

Quick Answer Summary (Claude Code โ€ข ChatGPT โ€ข Cursor โ€ข Gemini CLI)

Notion Official Workspace, Wiki & Specs MCP (Free / $10/mo) connects to AI coding and chat agents via claude mcp add notion -e NOTION_TOKEN=$NOTION_TOKEN -- npx -y @notionhq/notion-mcp-server. Free Tier: Notion Personal plan is Free with unlimited pages & Notion Integration token support. Paid Upgrade Threshold: Notion Plus ($10/seat/mo) + Notion AI required for unlimited team file uploads, synced databases & AI Q&A.

What Works for $0 (Free Tier)

Notion Personal plan is Free with unlimited pages & Notion Integration token support.

When a Paid Subscription Is Required

Notion Plus ($10/seat/mo) + Notion AI required for unlimited team file uploads, synced databases & AI Q&A.

Required Env Var(s): NOTION_TOKEN

1-Command Setup for Claude Code, Google Gemini CLI & Cursor

Copy the exact snippet for your AI coding agent โ€” merges alongside the StackOS Master Router so future tool recommendations happen automatically.

1. Claude Code CLI One-Liner
claude mcp add notion -e NOTION_TOKEN=$NOTION_TOKEN -- npx -y @notionhq/notion-mcp-server
2. Google Gemini CLI (~/.gemini/settings.json)
{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "NOTION_TOKEN": "${NOTION_TOKEN}"
      }
    },
    "stackos-router": {
      "httpUrl": "https://stackos-ai.vercel.app/api/mcp"
    }
  }
}
3. Cursor IDE & Claude Desktop (.mcp.json)
{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "NOTION_TOKEN": "${NOTION_TOKEN}"
      }
    },
    "stackos": {
      "url": "https://stackos-ai.vercel.app/api/mcp"
    }
  }
}
4. Non-Destructive Workspace Auto-Installer (Merges .mcp.json + SKILL.md)
curl -fsSL "https://stackos-ai.vercel.app/api/plugins/install?tools=notion&src=plugin-seo-notion" | node

Recommended SKILL.md / GEMINI.md Rule & GitHub README Badge

Read product specs and append structured sprint updates into shared Notion databases.

Notion Official Workspace, Wiki & Specs MCP verified on StackOSEmbed this live SVG badge in GitHub READMEs or engineering docs:

Best Companion Plugins for UI Design, Docs, Specs & Cloud Deploy