Skip to main content
ClaudeWave
makenotion avatar
makenotion

notion-mcp-server

View on GitHub

Official Notion MCP Server

MCP Servers4.4k stars576 forksTypeScriptMITUpdated 16d ago
Editor's note

The official Notion MCP server, published by Notion as an npm package (`@notionhq/notion-mcp-server`), exposes 22 tools that let MCP-compatible AI clients read and write Notion workspaces through the Notion API. Tools cover page creation and movement (`move-page`), data source operations (`query-data-source`, `create-a-data-source`, `update-a-data-source`, `list-data-source-templates`), content retrieval, comments, users, and search. Version 2.0.0 migrated to the Notion API dated 2025-09-03, replacing the older database-centric tools with a data source abstraction that uses `data_source_id` parameters. The server installs via npx and connects to Claude Desktop, Cursor, Zed, or any MCP client by adding a JSON config block with a Notion integration token. Notion also maintains a newer remote version with OAuth-based setup and is directing active support there instead. Writers, project managers, and developers who store work in Notion workspaces can use compatible AI clients to query, create, and update that content without leaving their coding or chat environment.

ClaudeWave Trust Score
97/100
Verified
Passed
  • Open-source license (MIT)
  • Actively maintained (<30d)
  • Healthy fork ratio
  • Mature repo (>1y old)
  • Documented (README)
Last scanned: 6/11/2026
Install in Claude Code / Claude Desktop
Method: Manual
Claude Code CLI
git clone https://github.com/makenotion/notion-mcp-server
claude_desktop_config.json (Claude Desktop)
{
  "mcpServers": {
    "notion": {
      "command": "node",
      "args": ["/path/to/notion-mcp-server/dist/index.js"]
    }
  }
}
1. Run the command above in your terminal (Claude Code), or paste the JSON config into claude_desktop_config.json (Claude Desktop).
2. Replace any <placeholder> values with your API keys or paths.
3. Restart Claude. The MCP server and its tools appear automatically.
💡 Clone https://github.com/makenotion/notion-mcp-server and follow its README for install instructions.
Use cases

MCP Servers overview

README preview not available. Visit the repo on GitHub for full documentation.

What people ask about notion-mcp-server

What is makenotion/notion-mcp-server?

+

makenotion/notion-mcp-server is mcp servers for the Claude AI ecosystem. Official Notion MCP Server It has 4.4k GitHub stars and was last updated 16d ago.

How do I install notion-mcp-server?

+

You can install notion-mcp-server by cloning the repository (https://github.com/makenotion/notion-mcp-server) or following the README instructions on GitHub. ClaudeWave also provides quick install blocks on this page.

Is makenotion/notion-mcp-server safe to use?

+

Our security agent has analyzed makenotion/notion-mcp-server and assigned a Trust Score of 97/100 (tier: Verified). See the full breakdown of passed checks and flags on this page.

Who maintains makenotion/notion-mcp-server?

+

makenotion/notion-mcp-server is maintained by makenotion. The last recorded GitHub activity is from 16d ago, with 180 open issues.

Are there alternatives to notion-mcp-server?

+

Yes. On ClaudeWave you can browse similar mcp servers at /categories/mcp, sorted by popularity or recent activity.

Deploy notion-mcp-server to your cloud

Ship this repo to production in minutes. Each platform spins up its own environment with editable env vars.

Maintain this repo? Add a badge to your README

Drop the badge into your GitHub README to show it's tracked on ClaudeWave. Each badge links back to this page and reflects the live Trust Score.

Featured on ClaudeWave: makenotion/notion-mcp-server
[![Featured on ClaudeWave](https://claudewave.com/api/badge/makenotion-notion-mcp-server)](https://claudewave.com/repo/makenotion-notion-mcp-server)
<a href="https://claudewave.com/repo/makenotion-notion-mcp-server"><img src="https://claudewave.com/api/badge/makenotion-notion-mcp-server" alt="Featured on ClaudeWave: makenotion/notion-mcp-server" width="320" height="64" /></a>

More MCP Servers