Notion MCP Server

AI-friendly MCP server for the Notion API — find, read, query, and update Notion workspaces with compact, agent-ready responses.

Unverified

stdio (local)

API key

TypeScript

View repo 907 Website npm

Add to your client

Copy the config for your MCP client and paste it into its config file.

Install / run

npx -y @suekou/mcp-notion-server

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

{
  "mcpServers": {
    "notion-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@suekou/mcp-notion-server"
      ],
      "env": {
        "NOTION_API_TOKEN": "your-integration-token"
      }
    }
  }
}

Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf

Before you start

A Notion account with an internal integration created at the Notion integrations dashboard
A Notion integration token (NOTION_API_TOKEN) with the needed capabilities
Pages or databases shared with the integration via Content access / Connections
Node.js 22 or newer (for local builds); npx for the default install

About Notion MCP Server

A Model Context Protocol server for connecting Notion to MCP-compatible clients such as Claude Desktop and Cursor. It targets the Notion API 2026-03-11 (current database/data source model) and is designed to keep responses compact for AI agents. The server provides simplified, schema-aware tools for the most common Notion workflows (find, read, query, create, edit) plus raw API tools for advanced operations, and optional interactive MCP Apps (Data Source Explorer and Page Workbench).

Tools & capabilities (10)

notion_find

Search Notion and discover the target page or data source to work with.

notion_read_page

Read a page compactly, returning page context and stable, editable block IDs.

notion_inspect_data_source

Inspect a data source's schema before querying or creating items.

notion_query_data_source_by_values

Schema-aware querying of a data source using simple values.

notion_create_data_source_item_from_values

Create a data source item from simple values.

notion_append_markdown

Safely append Markdown content to a page.

notion_append_content

Append content blocks (paragraphs, headings, lists, todos, quotes, callouts, code blocks, dividers) to a page.

notion_update_content

Update a page's content block.

notion_update_content_batch

Update multiple page content blocks in a single batch operation.

Raw Notion API tools

Raw JSON tools for advanced block, page, database, data source, comment, and user operations, used as a fallback when simplified tools do not cover the needed Notion API shape.

What this server can do

Notion MCP Server provides tools for these capabilities — tap one to see every MCP server that does the same:

Manage tasks & projects

When to use it

Let an AI agent search a Notion workspace and read pages with stable block references
Query and create rows in Notion databases (data sources) using simple values without crafting raw API payloads
Append or edit page content (Markdown, headings, lists, todos, callouts, code blocks) from an assistant
Perform advanced Notion API operations on blocks, pages, databases, comments, and users via raw tools

Security notes

Requires a Notion internal integration token (NOTION_API_TOKEN). Notion only lets an integration access pages and databases explicitly shared with it, and a connection added to a page also grants access to that page's children. Grant only the integration capabilities (read/insert/update content, comments, user info) that you actually need.

Notion MCP Server FAQ

How do I authenticate?

Create an internal Notion integration, copy its secret token, and set it as NOTION_API_TOKEN in your MCP host config. Notion only exposes pages and databases that have been explicitly shared with the integration.

Which Notion API version does it target?

It targets the Notion API 2026-03-11 and uses the current database/data source model.

Can I run a locally built checkout instead of npx?

Yes. Build the project with pnpm and point the config command to node with args ["/absolute/path/to/suekou-mcp-notion-server/build/index.js"], keeping NOTION_API_TOKEN in env.

What are MCP Apps in this server?

Optional interactive MCP Apps — Data Source Explorer and Page Workbench — for interactive Notion workflows, in addition to the standard tools, prompts, and resources.

#notion #notion-api #productivity #knowledge-base #database #docs #typescript #npm

Alternatives to Notion MCP Server

Compare all alternatives →

Task Master AI

Productivity

28k

AI-powered task-management system for AI-driven development that drops into Cursor, Windsurf, Claude Code, and more.

Unverified

stdio (local)

API key

JavaScript

15 tools

Updated 2 months agoRepo

Cua Driver

Productivity

19k

Background computer-use MCP server that drives native macOS, Windows, and Linux desktop apps without stealing focus.

Unverified

stdio (local)

No auth

Rust

33 tools

Updated 11 hours agoRepo

mcp-atlassian (community Jira/Confluence)

Productivity

5.4k

Self-hosted MCP server for Jira and Confluence Cloud and Server/Data Center.

Verified

stdio (local)

API key

Python

11 tools

Updated 2 months agoRepo

Compare Notion MCP Server with:

vs Task Master AI vs Cua Driver vs mcp-atlassian (community Jira/Confluence)vs Excel MCP Server