Notion MCP Server

Name: Notion MCP Server
Author: mikeysrecipes

@mikeysrecipes

代码仓库

关于 Notion MCP Server

暂无概览

#notion #mcp #server

基本信息

分类

记忆与知识

许可证

MIT license

运行时

node

传输方式

stdio

发布者

mikeysrecipes

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": [
        "-y",
        "@notionhq/notion-mcp-server"
      ],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\" }"
      }
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Notion MCP Server?

Notion MCP Server is a Model Context Protocol server that connects AI assistants to the Notion API, enabling LLMs to interact with Notion pages and databases through natural language instructions. It is designed for developers using MCP-compatible clients such as Claude Desktop or Cursor.

How to use Notion MCP Server?

Set up a Notion internal integration to obtain a bearer token, then configure the server in your client's mcp.json or claude_desktop_config.json using either npx or Docker. Ensure relevant pages and databases are connected to your integration via the Notion UI before making requests.

Key features of Notion MCP Server

Searches, reads, and comments on Notion pages
Creates new pages under specified parent pages
Retrieves content by page or database ID
Uses HTTP Bearer token for authentication
Cannot delete databases via MCP

Use cases of Notion MCP Server

Add a comment to a specific Notion page
Create a new page under a given parent page
Search for pages by name and retrieve their content
Fetch the content of a page using its direct ID

FAQ from Notion MCP Server

What permissions does the Notion integration need?

The integration can be configured with read-only access by checking only "Read content" in the Notion Integration's Capabilities tab. Security-conscious users may want to restrict permissions to limit risk to workspace data.

What are the runtime requirements?

The server runs via Node.js (using npx) or Docker. For npx, Node.js must be installed. Docker users can pull the official image mcp/notion or build locally with docker-compose build.

Where does my data live?

All data stays within your Notion workspace. The MCP server acts as a bridge between your AI client and the Notion API, but does not store or cache page content externally.

What are the known limitations?

The server intentionally limits the scope of the Notion API — for example, you cannot delete databases via MCP. There is a non-zero risk to workspace data when exposing it to LLMs, so read-only token usage is recommended for security.

How do I configure the transport and authentication?

The server uses the OPENAPI_MCP_HEADERS environment variable to pass an HTTP Authorization header with your Notion bearer token and the required Notion-Version header (set to 2022-06-28). No other transport methods are supported.

记忆与知识分类下的更多 MCP 服务器