Notion MCP Server

Give your AI full read/write access to Notion with one token and one paste. This is an agent-first Notion MCP server: your AI client (Claude Code, Claude Desktop, Cursor, VS Code, Cline, Zed - anything that speaks MCP) can create pages, query databases, append blocks, apply templates, comment, and upload files in natural language. It runs locally over stdio via the published package.

People who work with Notion and Transport and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-09-17 · ★ 171 · #9 OF 160 MAINTAINED PRODUCTIVITY · VERIFIED 2026-09-18

MIT · TypeScript servers · how we verify → /methodology

01 · Install Notion MCP Server

before you install - you'll need

Set NOTION_ALLOWED_OPERATIONS, NOTION_BLOCKED_OPERATIONS, MCP_TRANSPORT, MCP_AUTH_TOKEN before connecting. NOTION_TOKEN is optional or environment-specific per the README.

Claude Code

claude mcp add awkoy-notion-mcp-server -- npx -y notion-mcp-server

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "awkoy-notion-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "notion-mcp-server"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package notion-mcp-server - unscoped; check the name against the project README before installing

registry namespace io.github.awkoy is GitHub-verified and matches the repo owner

03 · What Notion MCP Server can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v3.1.0 · 2026-09-16

serve protocol revision 2026-07-28, and fix the destructive-confirmation accept path (v3.1.0)

v3.0.1 · 2026-09-15

build before testing in the npm publish workflow · surface child_page/child_database title as block text · describe blocks that keep their text outside rich_text · bump docker/setup-qemu-action from 4.2.0 to 4.3.0 in…

v3.0.0 · 2026-09-02

Changed · notion_execute is gone; notion_read and notion_write replace it, and operation is an enum. One tool ran every operation, so a client could only allow or prompt for all of Notion at once: MCP clients grant…

04 · Who maintains Notion MCP Server

notion-mcp-server is maintained by awkoy. It's the only MCP server we track from this author; the repo dates to Mar 2025.

05 · Facts

repository: github.com/awkoy/notion-mcp-server
category: productivity - ranked #9 of 160 actively-maintained productivity servers as of 2026-09-18.
release cadence: 8 releases in the last 90 days (latest 2026-09-16)
registry: io.github.awkoy/notion-mcp-server (active, first published 2026-07-03 · 7 versions)
packages: npm:notion-mcp-server

06 · Notion MCP Server FAQ

What is Notion MCP Server?

Is Notion MCP Server still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-17 and it shipped 8 releases in the last 90 days. We re-verify nightly.

How do I install Notion MCP Server?

Run `npx -y notion-mcp-server`. The README documents 5 environment variables (NOTION_TOKEN, NOTION_ALLOWED_OPERATIONS, NOTION_BLOCKED_OPERATIONS…) to set first. Set NOTION_ALLOWED_OPERATIONS, NOTION_BLOCKED_OPERATIONS, MCP_TRANSPORT, MCP_AUTH_TOKEN before connecting. NOTION_TOKEN is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Notion MCP Server run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Notion MCP Server

Alternatives to Notion MCP Server

Maintained productivity servers if Notion MCP Server isn't the fit.

Pairs well with

Servers that cover what Notion MCP Server doesn't - only shown when the pairing reason fits the companion.

More productivity MCP servers · Bugherd MCP · Claude Token Saver MCP · Quarterback · Enzyme

More TypeScript MCP servers · Azeth Protocol MCP Server · Containerization Assist · Agent Skill Loader · Backblaze B2 MCP Server · Camoufox MCP · see all