Notion API 的 AI 友好 MCP 服务器。它帮助代理查找、读取、查询和更新 Notion 工作区，同时保持响应足够简洁，以适应日常 AI 工作流程。

该服务器面向 Notion API 2026-03-11，并使用当前的数据库/数据源模型。它提供了 MCP 工具、提示、资源、结构化工具结果以及可选的 MCP 应用，用于交互式 Notion 工作流程。

精彩片段

• 搜索和目标发现，使用notion_find。
• 通过notion_read_page实现稳定块ID的紧凑页面读取。
• 通过notion_inspect_data_source进行数据源模式检查。
• 基于模式的数据源查询和项目创建，使用简单的数值。
• 简单的页面编辑工具，用于段落、标题、列表、待办事项、引用、标注、代码块、分隔符和安全的Markdown附加。
• Raw Notion API 工具，支持高级块、页面、数据库、数据源、评论和用户操作。
• 可选MCP应用：数据源浏览器和页面工作台。

快速启动

将此服务器添加到 MCP 主机，如 Claude Desktop：

保存配置后重启MCP主机。

设置指南

1.创建一个 Notion 集成

Notion MCP Server

AI-friendly MCP server for the Notion API. It helps agents find, read, query, and update Notion workspaces while keeping responses compact enough for day-to-day AI workflows.

This server targets the Notion API 2026-03-11 and uses the current database/data source model. It exposes MCP tools, prompts, resources, structured tool results, and optional MCP Apps for interactive Notion workflows.

Highlights

• 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.

Quick Start

Add this server to an MCP host such as Claude Desktop:

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

Restart your MCP host after saving the configuration.

Setup Guide

1. Create a Notion integration

Open the Notion integrations dashboard, then create a new internal integration.

2. Configure capabilities

Grant only the capabilities you need:

• Read content: required for search, page reads, data source retrieval, and queries.
• Insert content: required for creating pages/items and appending blocks.
• Update content: required for updating pages, blocks, and data source schemas.
• Read comments / Insert comments: required only for comment tools.
• User information: required only when using user lookup tools.

For full functionality during setup, enable read, insert, and update content. Add comment or user capabilities only if you plan to use those tools.

3. Grant content access

Open the Content access tab for your integration, then select the pages or databases you want the MCP server to read or edit.

You can also grant access from the target Notion page or database: open the ... menu, choose Connections, then add your integration.

Notion only lets an integration access pages and databases that have been shared with it. A connection added to a page can also access that page’s children.

4. Copy the internal integration token

Copy the integration secret. This value becomes NOTION_API_TOKEN in your MCP host config.