notion-mcp-server

by awkoy · Productivity · ★ 179

notion-mcp-server is an MCP server by awkoy. Notion MCP server with token auth: connect Claude Code, Claude Desktop, Cursor, VS Code and Codex to Notion pages, databases, comments and files. 3 tools, 94% less context than the official server, works on any plan, runs headless. It has 179 GitHub stars and ranks #148 of 1809 in Productivity by stars.

Category: Productivity
Author: awkoy
GitHub stars: 179
This week: Tracking since 18 Oct 2026
Weekly downloads: 2,491
Language: TypeScript
License: MIT (open source)
Last update: 2026-10-21 (3 days ago)
Links: Source Website npm

ai-agents
anthropic
chatgpt
claude
claude-code
claude-desktop
codex
cursor
gemini-cli
llm
markdown
mcp
+8 more

How to install notion-mcp-server

notion-mcp-server is published on npm as notion-mcp-server, and it is listed in the official MCP Registry. These steps assume it runs as a local stdio server, which is the usual setup.

Check the README. Confirm the start command and note any API keys or environment variables it needs (pass them with -e KEY=value or an env block). You need Node.js for npx.

Add it to Claude Code from a terminal:

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

Or add it to Cursor or Claude Desktop in .cursor/mcp.json or claude_desktop_config.json:

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

Restart the client and check it. Run claude mcp list, or open the client's MCP settings, and confirm notion-mcp-server and its tools are listed. The install guide covers VS Code and Codex.

Also listed in

Maintain this project? Get it featured ($99/mo, pinned at the top of Productivity) or see what featuring includes.

Report a problem with this listing

Frequently asked questions

What is notion-mcp-server?

notion-mcp-server is an MCP server by awkoy in the Productivity category. Notion MCP server with token auth: connect Claude Code, Claude Desktop, Cursor, VS Code and Codex to Notion pages, databases, comments and files. 3 tools, 94% less context than the official server, works on any plan, runs headless. It has 179 GitHub stars and ranks #148 of 1809 in Productivity by stars.

Is notion-mcp-server free and open source?

Yes. notion-mcp-server is published under the MIT license, so you can run, modify and self-host it at no cost. If it connects to a paid service, that service's own pricing and API terms still apply. Check the repository for the exact license text before using it commercially.

What are the alternatives to notion-mcp-server?

Other Productivity projects on MCP Harbor include markitdown, Agent-Reach, AstrBot. Each alternative links to its own page with stars, license and recent activity. The Productivity category ranks all 1809 by stars, and you can re-sort it by growth this week.

Alternatives to notion-mcp-server

markitdown★ 191,862

microsoft · Python

Python tool for converting files and office documents to Markdown.

Agent-ReachTrending★ 101,437

Panniantong · Python+2,844 stars this week (+2.9%)

Give your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.

AstrBotTrending★ 43,082

AstrBotDevs · Python+1,030 stars this week (+2.4%)

AI Agent Assistant & development framework that integrates lots of IM platforms, LLMs, plugins and AI feature, and can be your openclaw alternative. ✨

CopilotKit★ 38,201

CopilotKit · TypeScript

The Frontend Stack for Agents & Generative UI. React, Angular, Mobile, Slack, and more. Makers of the AG-UI Protocol

activepieces★ 25,196

activepieces · TypeScript+114 stars this week (+0.5%)

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

n8n-mcp★ 23,126

czlonkowski · TypeScript+32 stars this week (+0.1%)

A MCP for Claude Desktop / Claude Code / Windsurf / Cursor to build n8n workflows for you

All 1809 Productivity MCP servers →

Data last updated 25 October 2026. Stars and downloads are refreshed every day from GitHub and npm.