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 23 days ago.

Notion MCP Server

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

4 tools GitHub

No known CVEs

No license

Actively maintained

Last commit 23d 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

69/100across 5 weighted dimensions

How we score →

0255075100

−31

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 23 days ago.

Similar servers

Others in productivity

View all →

Memory MCP Server98

Persistent memory using a knowledge graph

85.9k 5

io.github.miroapp/mcp-server95

Official Miro MCP server - Supports context to code and creating diagrams, docs, and data tables.

104 7

Scrumboy95

a self-hosted project management & Kanban solution + Instant shareable boards

238 1

Obsidian Local Llm Hub93

All-in-one local AI hub for Obsidian — LLM chat with vault tools, MCP servers, RAG, workflow automation, encryption, and edit history. Fully private, no cloud required.

40 11

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?

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.

README

@shck-dev/notion-mcp

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

No workspace admin. No OAuth. No page sharing.
Just paste 3 values from your browser and go.

Blog Post | GitHub | npm

Features

Search — full-text search across your entire workspace
Export — download any page as clean markdown (headings, lists, code blocks, tables, links)
Import — write markdown back to Notion pages, from a string or local file
Create — spin up new child pages, optionally prefilled from a markdown string or file
Comments — list open discussions, add new comments, reply to threads
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
`notion_import_page`	Write markdown content to a Notion page (replaces content)
`notion_import_page_from_file`	Write a local `.md` file to a Notion page
`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_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

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

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

Quick start

1. Get credentials from your browser

Open notion.so in Chrome
Press F12 → Application → Cookies → www.notion.so
Copy the token_v2 cookie value → NOTION_TOKEN
Press F12 → Network tab, do any action in Notion
Find a POST request to api/v3/*, click it
From Request Headers: copy x-notion-active-user-header → NOTION_USER_ID
From Request Body (Payload): find spaceId → NOTION_SPACE_ID

2. Configure your MCP client

Claude Code

claude mcp add notion -- env NOTION_TOKEN=your_token NOTION_USER_ID=your_user_id NOTION_SPACE_ID=your_space_id bunx @shck-dev/notion-mcp

Claude Desktop / Cursor / any MCP client

Add to your MCP config (claude_desktop_config.json, .cursor/mcp.json, etc.):

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

Requirements

Bun runtime — curl -fsSL https://bun.sh/install | bash

Limitations

Internal API — undocumented, may break with Notion updates

... View full README on GitHub

Loading README…

Scored, not listed

Why this score

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

Score breakdown

69/100across 5 weighted dimensions

How we score →

0255075100

−31

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 23 days ago.

Similar servers

Others in productivity

View all →

Memory MCP Server98

Persistent memory using a knowledge graph

85.9k 5

io.github.miroapp/mcp-server95

Official Miro MCP server - Supports context to code and creating diagrams, docs, and data tables.

104 7

Scrumboy95

a self-hosted project management & Kanban solution + Instant shareable boards

238 1

Obsidian Local Llm Hub93

All-in-one local AI hub for Obsidian — LLM chat with vault tools, MCP servers, RAG, workflow automation, encryption, and edit history. Fully private, no cloud required.

40 11

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?