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 connecting productivity tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-12 · ★ 167 · #10 OF 139 MAINTAINED PRODUCTIVITY · VERIFIED 2026-08-25

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 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

v2.13.0 · 2026-08-02

bump actions/setup-node from 6.4.0 to 7.0.0 in the actions group · bump the npm-minor-patch group with 2 updates · give $defs bodies a real shape, not a self-$ref · confine path uploads to NOTION_UPLOAD_ROOT · bump…

v2.12.0 · 2026-07-10

bump @types/node from 26.0.0 to 26.0.1 in the npm-minor-patch group · bump the actions group with 5 updates · local path source + markdown/office MIME inference · New Contributors · @qch2012 made their first…

v2.11.0 · 2026-07-03

measured context-overhead comparison vs official server · add project logo (400x400) · add llms-install.md for agent-driven setup (Cline) · use data_source_id for relation targets · v2.11.0 - data_source_id for…

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 #10 of 139 actively-maintained productivity servers as of 2026-08-25.
release cadence: 10+ releases in the last 90 days (latest 2026-08-02)
registry: io.github.awkoy/notion-mcp-server (active, first published 2026-07-03 · 4 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-08-25, its last commit was 2026-08-12 and it shipped 10+ 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 4 environment variables (NOTION_TOKEN, NOTION_ALLOWED_OPERATIONS, NOTION_BLOCKED_OPERATIONS…) to set first. Set NOTION_ALLOWED_OPERATIONS, NOTION_BLOCKED_OPERATIONS, MCP_TRANSPORT 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 · Enzyme · Arabicfmt MCP

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