Log inSubmit server
MCP Notion Server logo

MCP Notion Server

by suekou

Connects MCP-compatible clients to Notion for search, reading, querying, editing, and data source operations.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Notion Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "suekou-mcp-notion-server": {
      "command": "npx",
      "args": [
        "-y",
        "@suekou/mcp-notion-server"
      ],
      "env": {
        "NOTION_API_TOKEN": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y @suekou/mcp-notion-server

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 26d ago.

Overview

suekou/mcp-notion-server MCP server connects MCP-compatible clients to the Notion API for finding, reading, querying, and updating workspace content. It provides simplified tools for common page and data source workflows, plus raw API tools for advanced operations. Use it when an agent needs controlled access to shared Notion pages, databases, data sources, comments, or users.

Use cases

  • Find pages and data sources in a Notion workspace
  • Read page content and retrieve editable block IDs
  • Query data sources using their inspected schemas
  • Create and update Notion pages or data source items
  • Append structured content or Markdown to pages

Key features

  • Notion page and data source search
  • Compact page reads with stable block IDs
  • Schema-aware data source queries and item creation
  • Structured page editing and Markdown append
  • Raw Notion API operations
  • Optional Data Source Explorer and Page Workbench apps

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

19/20 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 10d ago via OSV.dev · @suekou/mcp-notion-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars925Stargazers on the source repository.
npm downloads3.9kPackage downloads in the last 30 days.
Last commit2mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Notion Server works

What suekou/mcp-notion-server MCP server does

The suekou/mcp-notion-server MCP server exposes Notion workspace operations through the Model Context Protocol. It can search for pages and data sources, read page content, inspect data source schemas, query data source items, and create new items from simple values.

Page editing covers paragraphs, headings, lists, to-dos, quotes, callouts, code blocks, dividers, and Markdown appends. Additional tools update page or block content, support batch updates, and provide access to lower-level Notion API operations for blocks, pages, databases, data sources, comments, and users.

The server targets Notion API version 2026-03-11 and follows Notion's current database and data source model. It also exposes prompts, resources, structured tool results, and optional MCP Apps for a Data Source Explorer and Page Workbench.

How it works

An MCP host starts the server as a local Node.js process, typically through npx. The host passes a Notion internal integration token through the NOTION_API_TOKEN environment variable. Agents then invoke the exposed tools over MCP.

A practical workflow starts with notion_find to locate a page or data source. For pages, notion_read_page returns compact context with stable block IDs that can be used for later edits. For data sources, notion_inspect_data_source reveals the schema before a query or item creation request. Simplified tools handle common operations, while raw JSON tools are available when an operation requires a Notion API shape not covered by those helpers.

The integration can only access pages and databases shared with it. Sharing a page also gives the integration access to that page's children. Notion integration capabilities determine which classes of operations are available.

Setup and configuration

Create an internal integration in the Notion integrations dashboard, then enable the capabilities required by the workflows you plan to use. Read content is needed for search, page reads, data source retrieval, and queries. Insert content enables page or item creation and block appends. Update content is needed for page, block, and data source schema changes. Comment and user capabilities are only needed for the corresponding tools.

Copy the integration's internal token and configure it as NOTION_API_TOKEN in the MCP host. A standard configuration runs npx -y @suekou/mcp-notion-server. A locally built checkout can instead run the generated build/index.js file with Node.js.

The project uses Node.js 22 or newer and pnpm for development. Local contributors can install dependencies with the frozen lockfile, build the project, run tests, and use the MCP inspector.

Tools and capabilities

The suekou/mcp-notion-server MCP server includes capabilities for:

  • Finding pages and data sources with notion_find.
  • Reading pages with compact output and stable block identifiers.
  • Inspecting schemas before data source operations.
  • Querying data sources and creating items from simple values.
  • Appending Markdown or structured content to pages.
  • Updating content through individual or batch operations.
  • Calling raw Notion API operations for advanced blocks, pages, databases, data sources, comments, and users.
  • Using the optional Data Source Explorer and Page Workbench MCP Apps.

Limitations and notes

The Notion integration must be granted access to each target page or database; an integration token alone does not provide workspace-wide access. Required Notion capabilities also vary by tool, so enabling only read access will not support creation or editing.

The simplified tools are intended for common workflows. Raw API tools may be necessary for operations or payloads outside the simplified interfaces. Comment and user operations require their respective Notion integration permissions. Restart the MCP host after changing its configuration.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Notion Server

suekou/mcp-notion-server is an MCP server that connects MCP-compatible clients to the Notion API. Its main tools find and read pages, inspect and query data sources, create items, edit page content, and access advanced Notion operations for blocks, comments, users, pages, and databases.

Install it by configuring your MCP host to run `npx -y @suekou/mcp-notion-server` and provide `NOTION_API_TOKEN`. Create a Notion internal integration, grant the required capabilities and content access, then restart the host after saving the configuration.

Yes, suekou/mcp-notion-server works with Cursor through its MCP settings. Add the server command and `NOTION_API_TOKEN` to the host configuration, then restart Cursor so it can launch the local stdio server.

The required permissions depend on the tools you use. Read content supports search, reads, retrieval, and queries; insert content supports creation and appending; update content supports edits and schema changes. Comment and user tools require their corresponding capabilities.

Related MCP servers

All in Other Tools and Integrations All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Notion Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/suekou-mcp-notion-server?style=directory)](https://allmcps.com/mcp/suekou-mcp-notion-server)
HTML Embed
<a href="https://allmcps.com/mcp/suekou-mcp-notion-server"><img src="https://allmcps.com/api/badge/suekou-mcp-notion-server?style=directory" alt="MCP Notion Server on AllMCPs" /></a>