Notion MCP Server

Notion MCP server — search, export, and import pages as markdown

2 4 tools GitHub

No known CVEs

No license

Actively maintained

Last commit 6d ago

Works with most clients

Transport: stdio, http

4 tools · ~175 tok

Grade A · 0.1% of 200K ctx

Edit this pageView history

Productivity

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "notion": {
      "env": {
        "NOTION_TOKEN": "your_token_v2_value",
        "NOTION_USER_ID": "your_user_id",
        "NOTION_SPACE_ID": "your_space_id"
      },
      "args": [
        "@shck-dev/notion-mcp"
      ],
      "command": "bunx"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-shck-dev-notion-mcp)](https://mcppedia.org/s/io-github-shck-dev-notion-mcp)

Read me

What Notion MCP Server does

Notion MCP Server — search, export, and import pages as markdown

Test This Server

No automated test available for this server. Check the GitHub README for setup instructions.

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

71/100across 5 weighted dimensions

How we score →

0255075100

−29

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

No package registry to scan.

Inventory

Tools (4)

Click any tool to inspect its schema.

~175 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is Notion MCP Server safe to use?: Notion MCP Server has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.
How do I install Notion MCP Server?: Notion MCP Server supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can Notion MCP Server do?: Notion MCP Server provides 4 tools: notion_search, notion_export_page, notion_import_page, notion_import_page_from_file. See the full tools list on the server page for descriptions and parameters.
What AI clients work with Notion MCP Server?: Notion MCP Server is compatible with claude-desktop, cursor, claude-code. It uses stdio and http transport.
Is Notion MCP Server actively maintained?: Notion MCP Server is actively maintained — last commit was 6 days ago. It has 2 GitHub stars.

Similar servers

Others in productivity

View all →

Sequential Thinking MCP Server98

Dynamic problem-solving through sequential thought chains

87.8k 1

Memory MCP Server96

Persistent memory using a knowledge graph

87.8k 5

Qmd95

mini cli search engine for your docs, knowledge bases, meeting notes, whatever. Tracking current sota approaches while being all local

27.2k 4

Superlocalmemory MCP Server94

Local-first AI memory with knowledge graphs and hybrid search. 17+ AI tools via MCP. Free.

188 6

MCP Security Weekly

Get CVE alerts and security updates for Notion MCP Server and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

{ "mcpServers": { "notion": { "env": { "NOTION_TOKEN": "your_token_v2_value", "NOTION_USER_ID": "your_user_id", "NOTION_SPACE_ID": "your_space_id" }, "args": [ "@shck-dev/notion-mcp" ], "command": "bunx" } } }

Features

Search — full-text search across your entire workspace

Export — download any page as clean markdown (headings, lists, to-do, code blocks, tables, links, images with viewable URLs)

Import — write markdown back to Notion pages (replaces content), from a string or local file

Append — add markdown to the end of a page without touching existing content

Create — spin up new child pages, optionally prefilled from a markdown string or file

Images — upload a local image to a page, or reference an external URL

Comments — list open discussions, add new comments, reply to threads

One-command setup — npx @shck-dev/notion-mcp init: paste a browser "Copy as cURL" and it extracts + saves your credentials

Prompts & resources — a notion_setup prompt and a notion://guide resource for in-client onboarding

Zero setup friction — uses the same internal API as the Notion web app; if you can see it in your browser, this server can access it

Tools

Tool	Description
`notion_search`	Full-text search across all pages in your workspace
`notion_export_page`	Export any Notion page as markdown; image links resolve to viewable CDN URLs (pass `image_dir` to download images locally instead)
`notion_import_page`	Write markdown to a Notion page — replaces all existing content
`notion_import_page_from_file`	Write a local `.md` file to a page — replaces all content
`notion_append_to_page`	Append markdown to the end of a page (non-destructive)
`notion_append_to_page_from_file`	Append a local `.md` file to the end of a page (non-destructive)
`notion_create_page`	Create a new sub-page, optionally prefilled with markdown
`notion_create_page_from_file`	Create a new sub-page from a local `.md` file
`notion_add_image`	Append an image to the end of a page — local file is uploaded to Notion, http(s) URL is referenced as-is
`notion_list_comments`	List open discussion threads on a page
`notion_add_comment`	Start a new discussion — inline (anchored to text) or block-level
`notion_reply_comment`	Reply to an existing discussion thread
`notion_init`	Paste a browser "Copy as cURL" to extract & save credentials

Tool

Description

notion_search

Full-text search across all pages in your workspace

notion_export_page

Export any Notion page as markdown; image links resolve to viewable CDN URLs (pass image_dir to download images locally instead)

notion_import_page

Write markdown to a Notion page — replaces all existing content

notion_import_page_from_file

Write a local .md file to a page — replaces all content

notion_append_to_page

Append markdown to the end of a page (non-destructive)

notion_append_to_page_from_file

Append a local .md file to the end of a page (non-destructive)

notion_create_page

Create a new sub-page, optionally prefilled with markdown

notion_create_page_from_file

Create a new sub-page from a local .md file

notion_add_image

Append an image to the end of a page — local file is uploaded to Notion, http(s) URL is referenced as-is

notion_list_comments

List open discussion threads on a page

notion_add_comment

Start a new discussion — inline (anchored to text) or block-level

notion_reply_comment

Reply to an existing discussion thread

notion_init

Paste a browser "Copy as cURL" to extract & save credentials

Why not the official Notion API?

	This MCP server	Official Notion API
Setup	Paste 3 values from DevTools	Create integration, get admin approval, share pages
Page access	Everything you can see	Only explicitly shared pages
Markdown	Bidirectional (export + import)	Read-only blocks API
Auth	Cookie (`token_v2`)	OAuth / integration token

This MCP server

Official Notion API

Setup

Paste 3 values from DevTools

Create integration, get admin approval, share pages

Page access

Everything you can see

Only explicitly shared pages

Markdown

Bidirectional (export + import)

Read-only blocks API

Auth

Cookie (token_v2)

OAuth / integration token

Trade-off: The internal API is undocumented and may change. Token expires periodically (re-grab from browser).

Frequently Asked Questions

Is Notion MCP Server safe to use?

Notion MCP Server has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments.

How do I install Notion MCP Server?

Notion MCP Server supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can Notion MCP Server do?

Notion MCP Server provides 4 tools: notion_search, notion_export_page, notion_import_page, notion_import_page_from_file. See the full tools list on the server page for descriptions and parameters.

What AI clients work with Notion MCP Server?

Notion MCP Server is compatible with claude-desktop, cursor, claude-code. It uses stdio and http transport.

Is Notion MCP Server actively maintained?

Notion MCP Server is actively maintained — last commit was 6 days ago. It has 2 GitHub stars.