Tool Connections & Integrations · Preview

notion-mcp-server

Official Notion MCP Server

Best fitUsers who want source-backed project understanding before installing it.

Check whether this project matches your task before installing it.

What it can domcp_config, recipe, host_instruction, eval, preflight

Review the portable capability path.

Before continuingVerify in a sandbox

Do not treat a preview pack as a proven local install.

GitHub snapshot4.3k stars

568 forks · 22 contributors

Official first step Read manual preview Source repository

Preview status · 2026-05-17

What is notion-mcp-server?

The MCP server acts as a bridge between AI clients (such as Claude, Cursor, or GitHub Copilot) and the Notion API. Instead of manually implementing API calls, AI agents can discover and in...
Best fit: Users who want source-backed project understanding before installing it.
Capability added to an AI workflow: mcp_config, recipe, host_instruction, eval, preflight
Evidence base: https://github.com/makenotion/notion-mcp-server, https://github.com/makenotion/notion-mcp-server, https://github.com/makenotion/notion-mcp-server#readme
Preview pages are noindex until English quality, canonical, and citation gates pass.
notion-mcp-server still needs sandbox verification before production use.

Quick decision

Use this section to decide whether the project is worth a deeper read.

Best forUsers who want source-backed project understanding before installing it.

Match the project to your task before installing it.

Capabilitymcp_config, recipe, host_instruction, eval, preflight

Official Notion MCP Server

Repositorymakenotion/notion-mcp-server

4.3k stars · 568 forks

What it can do

Translate the upstream project into concrete capabilities the user can judge before installing.

Introduction to Notion MCP Server

Related topics: Quick Start Guide, System Architecture

Sources: [README.md:1-30]()[package.json:7-10]()

Quick Start Guide

Related topics: Introduction to Notion MCP Server, Authentication System, npm Installation and Configuration

Sources: [CLAUDE.md:1-10]()

System Architecture

Related topics: Transport Layers, MCP Proxy Implementation, Available MCP Tools

Sources: [CLAUDE.md](https://github.com/makenotion/notion-mcp-server/blob/main/CLAUDE.md)

Transport Layers

Related topics: System Architecture, Authentication System

Sources: [README.md](https://github.com/makenotion/notion-mcp-server/blob/main/README.md)

MCP Proxy Implementation

Related topics: System Architecture, Available MCP Tools

Sources: [src/openapi-mcp-server/mcp/proxy.ts:52-66]()

Sources: https://github.com/makenotion/notion-mcp-server, Human Manual, Project Pack evidence, and downstream validation signals.

Community Discussion Evidence

Project-level external discussion stays visible on the detail page, not only inside the manual.

Stars4.3k stars

Forks568 forks

Contributors22 contributors

Licenseunknown

Community Discussion Evidence

12 source-linked items

Review these external discussions before using notion-mcp-server with real data or production workflows. They are review inputs, not standalone proof that the project is production-ready.

01
Ontheia listed as compatible client — works great with notion-mcp-server
github / github_issue
02
synced_block_reference: URL inside url= attribute gets auto-converted to
github / github_issue
03
API-create-a-data-source and API-update-a-data-source return invalid_req
github / github_issue
04
v2.2.1 ships stale bin/cli.mjs — PR #212 double-serialization fix not in
github / github_issue
05
Feature Request: Support local file upload for images and files
github / github_issue
06
Bug Report: Notion MCP — Status Property "in_progress" Group Options Not
github / github_issue
07
Bug: notion-create-view silently drops FILTER on Status property (no err
github / github_issue
08
Enhancement: Expand blockObjectRequest to support all Notion block types
github / github_issue
09
BUG: Tool `query_data_sources` not available
github / github_issue
10
[Bug] FILTER directive in view DSL silently drops filters for Relation a
github / github_issue
11
Schema quality: 8 required parameters missing descriptions
github / github_issue
12
OAuth token expires too frequently — requires re-authentication 3+ times
github / github_issue

How to start

Only source-backed commands are shown here. Verify them in an isolated environment first.

Try the prompt first

Test the workflow without installing the upstream project.

preview

Read the Human Manual

Understand inputs, outputs, limits, and failure modes.

manual

Take context to your AI host

Use the compiled assets in your preferred AI environment.

context

Run sandbox verification

Confirm install commands and rollback before using a primary environment.

verify

npx @notionhq/notion-mcp-server

Official start command · https://github.com/makenotion/notion-mcp-server#readme · verified: yes

Human Manual

The English page must expose the real manual, not a short placeholder.

8+ sections · Human Manual