MCP.so
登录

Notion MCP Server

@mikeysrecipes

基本信息

分类

记忆与知识

许可证

MIT license

传输方式

stdio

作者

mikeysrecipes

关于 Notion MCP Server

暂无概览

Notion MCP Server 配置

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

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

Notion MCP Server 工具

24

Notion | Retrieve a user Error Responses: 400: 400

Notion | List all users Error Responses: 400: 400

Notion | Retrieve your token's bot user Error Responses: 400: Bad request

Notion | Search by title Error Responses: 400: Bad request

Notion | Retrieve block children Error Responses: 400: Bad request

Notion | Append block children Error Responses: 400: Bad request

Notion | Retrieve a block Error Responses: 400: Bad request

Notion | Update a block Error Responses: 400: Bad request

Notion | Delete a block Error Responses: 400: Bad request

Notion | Retrieve a page Error Responses: 400: Bad request

Notion | Update page properties Error Responses: 400: Bad request

Notion | Create a page Error Responses: 400: Bad request

Notion | Retrieve a page property item Error Responses: 400: Bad request

Notion | Retrieve comments Error Responses: 400: Bad request

Notion | Create comment Error Responses: 400: Bad request

Notion | Query a data source Error Responses: 400: Bad request

Notion | Retrieve a data source Error Responses: 400: Bad request

Notion | Update a data source Error Responses: 400: Bad request

Notion | Create a data source Error Responses: 400: Bad request

Notion | List templates in a data source Error Responses: 400: Bad request

Notion | Retrieve a database Error Responses: 400: Bad request

Notion | Move a page Error Responses: 400: Bad request

Notion | Retrieve a page as Markdown Error Responses: 400: Bad request 403: The integration lacks the read/update content capability required for this page. 404: Page not found or not shared with the integration. 429: Rate limited.

Notion | Update a page's content as Markdown Error Responses: 400: Bad request 403: The integration lacks the read/update content capability required for this page. 404: Page not found or not shared with the integration. 409: Conflict (e.g. row limit exceeded). 429: Rate limited.

概览

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

常见问题

1

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.

2

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

3

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.

4

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.

5

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 服务器