Notion MCP

Name: Notion MCP
Author: kevupton

Verified · ai.npm:@alfe

MCP server by kevupton · updated today · 540 downloads a week

Score 76

Notion MCP proxy server — bridges the official @notionhq/notion-mcp-server with Alfe OAuth credentials Notion MCP is published by ai.npm:@alfe from its verified domain in the official MCP Registry.

Install Add to Cursor Add to VS Code Website

Works withClaude Code Claude Desktop Cursor Codex Gemini CLI VS Code Windsurf Antigravity CLI

Licence

UNLICENSED: permissive, fine for commercial use

Quality

Clear description, published package or server URL, original repository

Security

Not checked yet. What we check

Install Notion MCP

Built from the published package, never by AI

claude mcp add notion-mcp -- npx -y @alfe.ai/notion-mcp

Run in your terminal. Add --scope user to use it in every project.

Step-by-step: install Notion MCP in Claude Code

{
  "mcpServers": {
    "notion-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@alfe.ai/notion-mcp"
      ]
    }
  }
}

Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.

Step-by-step: install Notion MCP in Claude Desktop

{
  "mcpServers": {
    "notion-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@alfe.ai/notion-mcp"
      ]
    }
  }
}

Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).

Step-by-step: install Notion MCP in Cursor

{
  "servers": {
    "notion-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@alfe.ai/notion-mcp"
      ]
    }
  }
}

Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".

Step-by-step: install Notion MCP in VS Code

codex mcp add notion-mcp -- npx -y @alfe.ai/notion-mcp

Step-by-step: install Notion MCP in Codex

{
  "mcpServers": {
    "notion-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@alfe.ai/notion-mcp"
      ]
    }
  }
}

Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).

Step-by-step: install Notion MCP in Antigravity CLI

gemini mcp add notion-mcp npx -y @alfe.ai/notion-mcp

Gemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.

Step-by-step: install Notion MCP in Gemini CLI

MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the notion-mcp block.

Weekly newsletter

Like Notion MCP? Get the best new MCP servers every week

The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.

Alternatives to Notion MCP

All alternatives →

OpenWork MCP Gateway different-ai

Your OpenWork org's skills, plugins, workflows, and connections through one OAuth MCP URL.

AFA Remote 24k

Modelcontextprotocol Core modelcontextprotocol

Model Context Protocol for TypeScript — public Zod schemas (spec + OAuth/OpenID) (with updated dependencies)

AAA Local 14k

Agents MCP electric-sql

Model Context Protocol registry, transports, and OAuth bridges for Electric Agents

AAA Local 10k

MCP Remote punkpeye

Remote proxy for Model Context Protocol, allowing local-only clients to connect to remote servers using oAuth

AAA Local 505k/wk

Agentmesh MCP Proxy microsoft

Public Preview — Security proxy for MCP servers: The Firewall for Model Context Protocol

AAA Local 6.5k

NotFairnowork-studio

OAuth MCP for Google, Meta, X, LinkedIn, Reddit, TikTok, GSC, GA4, WordPress and GHL.

AAA Remote 4.0k

Notion MCP vs OpenWork MCP Gateway Notion MCP vs Modelcontextprotocol Core Notion MCP vs Agents MCP

Notion MCP: common questions

How do I install Notion MCP?

In Claude Code run claude mcp add notion-mcp -- npx -y @alfe.ai/notion-mcp. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.

Is Notion MCP the official server?

Notion MCP is published by ai.npm:@alfe from its verified domain in the official MCP Registry.

Is Notion MCP free?

The code is published under the UNLICENSED licence. The service it connects to may have its own pricing.

Is Notion MCP safe to use?

It scores 76 of 100. Grades: licence A, quality C. The security check has not run for it yet. Review the code before you install. How grades work.

What are alternatives to Notion MCP?

Similar MCP servers: OpenWork MCP Gateway, Modelcontextprotocol Core, Agents MCP, MCP Remote.

Does Notion MCP work with ChatGPT?

Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.