M
MCP Directory CURATED DIRECTORY
911 MCP servers indexed
中文
← Back to directory
N

Notion MCP Server

Community
An AI-friendly MCP server for Notion workflows
How to install ↓ Compare GitHub source repository ↗
Category
Collaboration #27 of 55
Stars
★ 921 Very popular
Transport
stdio (local process)
Runtime
Node.js 22+
Credentials
API key / credential required
License
MIT
Last commit
Tools
9
54FMRS · D

An MIT-licensed Notion MCP server covering common workflows from search and reading through data source operations and page editing. The source shows stdio-based configuration and suitability for AI workflows with explicitly configured Notion integration access. The repository is not maintained by Notion, so it is not an official server.

Strongest · Setup experience 13/20 Weakest · Reliability 9/20

Reliability
9/20
Security and permissions
11/20
Maintenance
9/20
Documentation
12/20
Setup experience
13/20
Why each score
Reliability 9/20
The README describes tools, prompts, resources, and structured results after MCP initialization, but no server manifest, source files, CI, or committed tests are provided to verify startup, handshake, tool-list consistency, or implementation behavior. The README mentions pnpm build and test, but that is not reviewable execution evidence, so the static-calibration cap and uncertainty require deductions.
Security and permissions 11/20
The credential is supplied through NOTION_API_TOKEN, and the documentation describes capability-based authorization and sharing-based Notion content access, showing basic scoping and least-privilege awareness. Points are deducted because the server includes create, update, raw API, and comment operations; the README does not establish confirmation for dangerous actions, fully disclose data flows, or provide code-level credential-handling evidence.
Maintenance 9/20
The repository is not archived and has an MIT license, while the project documentation identifies a runtime, package manager, and development commands. There is no evidence here of release history, commit activity, dependency-update practice, issue response, or a security-response channel, so the score remains moderate-low.
Documentation 12/20
The README covers installation, integration creation, capability permissions, content access, mainstream-client configuration, recommended workflows, and links to layered documentation. Points are deducted because tool parameters, limits, costs, and troubleshooting details are largely delegated to documents not supplied in the prompt, while the manifest and implementation are unavailable for review.
Setup experience 13/20
The README provides both an npx-based setup and a local node configuration, with examples for Claude Desktop, Cursor, and other MCP hosts; the flow from integration creation to connection configuration is reasonably clear. Points are deducted because Node.js 22 and pnpm are required, and platform compatibility, build output, and actual startup are not verified by source files or CI/tests.

Static review · not runListed 2026-07-29

Read the FMRS scoring method →

Fit and risk

What it can accessUses the network

Best for

  • Users who need AI agents to access Notion workspaces
  • MCP workflows involving common page editing and data source operations
  • Notion API workflows that benefit from compact responses and simplified tools

Not for

  • Workflows that do not use Notion
  • Users who need to access content that has not been shared with the integration
  • Cases requiring advanced API shapes not covered by the simplified tools when raw JSON tools are unsuitable

Required permissions

  • Read content is required for search, page reads, data source retrieval, and queries
  • Insert content is required for creating pages or items and appending blocks
  • Update content is required for updating pages, blocks, and data source schemas
  • Read comments and Insert comments are required only for comment tools
  • User information is required only for user lookup tools
  • The integration can access only pages and databases shared with it

Risks and side effects

  • With insert or update capabilities enabled, an agent can create or modify authorized Notion content
  • Overly broad access grants may expose unnecessary pages or databases to the server
  • Relevant operations may fail when required Notion capabilities or content access are missing
  • The server targets Notion API 2026-03-11 and the current data source model

Setup

Before you start

Runtime：Node.js 22+

NOTION_API_TOKEN requiredsecret The internal integration secret (secret_...) from the Notion integrations dashboard (notion.so/profile/integrations); grant it content access to the pages/databases you want it to reach.

Add install_config to the MCP host configuration, replace NOTION_API_TOKEN with the Notion internal integration token, and restart the MCP host. First create an internal integration in Notion, configure the required capabilities, and grant access to target pages or databases in Content access. Access can also be granted from a target page or database through its Connections menu.

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

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

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

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal
claude mcp add notion -e NOTION_API_TOKEN=your-integration-token -- npx -y @suekou/mcp-notion-server

Run it in a terminal; replace any <…> placeholders with your own values first.

Generate and validate client config

Check that it works

After adding the config and restarting your MCP host, confirm tools like notion_find and notion_read_page appear in the client's tool list; then ask the AI to run notion_find against your workspace — returning page or data source results proves the connection works.

Troubleshooting

  1. Check that NOTION_API_TOKEN contains the correct internal integration token
  2. Restart the MCP host after saving configuration changes
  3. Verify that the required read, insert, or update capabilities are enabled
  4. Verify that the target page or database is granted in Content access or connected through Connections
  5. For full functionality, check that read, insert, and update content capabilities are enabled

Things to try

Once connected, you can ask your AI assistant things like:

  • Use notion_find to search my Notion workspace for pages about the project plan
  • Read the page you just found and summarize its content
  • Inspect this data source's schema, then filter for all items that are not done
  • Append a Markdown section with a todo list to the end of that document

Tools 9

notion_find read-only
Find pages or data sources.
notion_read_page read-only
Read page content with stable block IDs.
notion_inspect_data_source read-only
Inspect a data source schema.
notion_query_data_source_by_values read-only
Query a data source using simple values.
notion_create_data_source_item_from_values writes
Create a data source item from simple values.
notion_append_markdown writes
Safely append Markdown to a page.
notion_append_content writes
Append common content blocks to a page.
notion_update_content writes
Update page content.
Show 1 more tools
notion_update_content_batch writes
Update page content in batches.

Use cases

Finding and reading Notion pages
Inspecting, querying, and creating data source items
Appending paragraphs, headings, lists, todos, quotes, callouts, code blocks, and dividers
Updating page content and performing batch edits
Using the optional Data Source Explorer and Page Workbench MCP Apps

Supported clients

Claude Desktop
Cursor

Listed from the project's documentation, not tested by this site.

Overview

An MCP server that connects Notion with MCP-compatible clients and supports finding, reading, querying, and updating Notion workspaces. It targets the Notion API 2026-03-11, uses the current data source model, and provides compact responses, structured tool results, prompts, resources, and optional interactive MCP Apps.

Similar servers

Compare with other MCP servers

Source revision efa09a200932 Data synced 2026-10-19 Read the FMRS scoring method