Notion MCP Server

@suekou

About Notion MCP Server

A Model Context Protocol server for connecting Notion to MCP-compatible clients

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Notion MCP Server?

Notion MCP Server is an MCP (Model Context Protocol) server for the Notion API (version 2026-03-11) that helps AI agents find, read, query, and update Notion workspaces while keeping responses compact for AI workflows. It exposes MCP tools, prompts, resources, structured tool results, and optional MCP Apps for interactive Notion workflows.

How to use Notion MCP Server?

Install by adding the server configuration to an MCP host (e.g., Claude Desktop) using npx -y @suekou/mcp-notion-server and setting the NOTION_API_TOKEN environment variable. Create a Notion internal integration, grant the required capabilities (read, insert, update content), share target pages/databases with the integration, and copy the integration token. After saving the configuration, restart the MCP host.

Key features of Notion MCP Server

Search and target discovery with notion_find.
Compact page reading with stable block IDs via notion_read_page.
Data source schema inspection with notion_inspect_data_source.
Schema-aware data source querying and item creation with simple values.
Simple page editing tools for paragraphs, headings, lists, todos, quotes, callouts, code blocks, dividers, and safe Markdown append.
Raw Notion API tools for advanced block, page, database, data source, comment, and user operations.
Optional MCP Apps: Data Source Explorer and Page Workbench.

Use cases of Notion MCP Server

Agents searching for pages and reading their content with stable block IDs.
Querying and updating database or data source items using schema-aware tools.
Editing page content with simple editing tools (paragraphs, headings, lists, etc.).
Performing advanced operations using raw Notion API tools.
Interactively exploring data sources and page structure with MCP Apps.

FAQ from Notion MCP Server

What runtime dependencies does Notion MCP Server have?

For usage, only an MCP host is required. For development, Node.js 22 or newer and pnpm are needed.

How does authentication work?

Authentication uses a Notion internal integration token set as the NOTION_API_TOKEN environment variable in the MCP host configuration.

Which Notion API version does it support?

It targets the Notion API version 2026-03-11.

What are the content access limitations?

Notion only allows an integration to access pages and databases that have been explicitly shared with it, either via the integration’s Content access tab or from the page/database Connections menu.

What transport does it use?

It uses standard MCP stdio transport, as configured with the command and args in the MCP host settings.

Frequently asked questions

What runtime dependencies does Notion MCP Server have?

For usage, only an MCP host is required. For development, Node.js 22 or newer and pnpm are needed.

How does authentication work?

Authentication uses a Notion internal integration token set as the `NOTION_API_TOKEN` environment variable in the MCP host configuration.

Which Notion API version does it support?

It targets the Notion API version 2026-03-11.

What are the content access limitations?

Notion only allows an integration to access pages and databases that have been explicitly shared with it, either via the integration’s Content access tab or from the page/database Connections menu.

What transport does it use?

It uses standard MCP stdio transport, as configured with the `command` and `args` in the MCP host settings.

Comments

Basic information

More Memory & Knowledge MCP servers

Mcp Knowledge Graph

shaneholloman

MCP server enabling persistent memory for Claude through a local knowledge graph - fork focused on local development

871

The Cloud

Teka

The Cloud is the AI-native workspace that gives every AI — Claude, ChatGPT, Gemini, and other Frontier & Free or Local models — shared memory and real agents. Not cloud computing: thecloud.so is one workspace where your

Anytype MCP Server

anyproto

An MCP server enabling AI assistants to interact with Anytype - your encrypted, local and collaborative wiki - to organize objects, lists, and more through natural language.

467

Docs MCP Server

arabold

Grounded Docs MCP Server: Open-Source Alternative to Context7, Nia, and Ref.Tools

1.5K

MCP Apple Notes

RafalWilinski

Talk with your notes in Claude. RAG over your Apple Notes using Model Context Protocol.

401