Notion Mcp 服务器

什么是 Notion MCP 服务器？

Notion MCP 服务器是一个官方服务器，旨在增强 Notion 的功能，Notion 是一个流行的生产力和组织工具。该服务器作为后端解决方案，使用户能够更有效地管理他们的 Notion 工作区，提供简化工作流程和改善协作的功能。

Notion MCP 服务器的特点

• 实时协作：该服务器支持实时更新，允许多个用户同时在同一 Notion 页面上工作而没有延迟。
• 数据同步：确保在 Notion 中所做的所有更改在设备之间同步，为用户提供无缝体验。
• 自定义集成：用户可以集成各种第三方应用程序和服务，增强 Notion 的功能。
• 用户管理：该服务器提供强大的用户管理功能，允许管理员控制不同用户的访问权限。
• API 访问：开发人员可以利用 API 创建与 Notion 数据配合使用的自定义应用程序或集成。

如何设置 Notion MCP 服务器

1. 安装：首先从 GitHub 的官方存储库下载 Notion MCP 服务器。
2. 配置：按照文档中提供的设置说明配置服务器以满足您的需求。
3. 连接到 Notion：将您的 Notion 账户链接到服务器，以启用数据同步和访问所有功能。
4. 测试：设置完成后，进行测试以确保所有功能正常工作。
5. 部署：一旦一切配置和测试完成，便可在您的组织或个人项目中部署服务器。

常见问题解答

问：Notion MCP 服务器是免费使用的吗？

答：是的，Notion MCP 服务器是开源的，免费提供。然而，如果用户选择在付费服务器上托管，可能会产生费用。

问：我可以自定义 Notion MCP 服务器吗？

答：当然可以！该服务器设计为可自定义，允许开发人员修改代码以满足他们的特定需求。

问：运行 Notion MCP 服务器的系统要求是什么？

答：该服务器可以在大多数现代操作系统上运行，但建议拥有稳定的互联网连接和足够的 RAM 以处理多个用户。

问：我如何报告问题或为项目做贡献？

答：用户可以通过访问 GitHub 存储库并遵循那里提供的贡献指南来报告问题或为项目做贡献。

问：Notion MCP 服务器有支持吗？

答：虽然没有官方支持团队，但用户可以通过论坛和 GitHub 问题页面向社区寻求帮助。

Notion MCP Server

[!NOTE]

We’ve introduced Notion MCP (Beta), a remote MCP server with the following improvements:

• Easy installation via standard OAuth. No need to fiddle with JSON or API token anymore.
• Powerful tools tailored to AI agents. These tools are designed with optimized token consumption in mind.

Learn more and try it out here

This project implements an MCP server for the Notion API.

Installation

1. Setting up Integration in Notion:

Go to https://www.notion.so/profile/integrations and create a new internal integration or select an existing one.

While we limit the scope of Notion API's exposed (for example, you will not be able to delete databases via MCP), there is a non-zero risk to workspace data by exposing it to LLMs. Security-conscious users may want to further configure the Integration's Capabilities.

For example, you can create a read-only integration token by giving only "Read content" access from the "Configuration" tab:

2. Connecting content to integration:

Ensure relevant pages and databases are connected to your integration.

To do this, visit the Access tab in your internal integration settings. Edit access and select the pages you'd like to use.

Alternatively, you can grant page access individually. You'll need to visit the target page, and click on the 3 dots, and select "Connect to integration".

3. Adding MCP config to your client:

Using npm:

Add the following to your .cursor/mcp.json or claude_desktop_config.json (MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json)

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

Using Docker:

There are two options for running the MCP server with Docker:

Option 1: Using the official Docker Hub image:

Add the following to your .cursor/mcp.json or claude_desktop_config.json:

{
  "mcpServers": {
    "notionApi": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "OPENAPI_MCP_HEADERS",
        "mcp/notion"
      ],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\":\"Bearer ntn_****\",\"Notion-Version\":\"2022-06-28\"}"
      }
    }
  }
}

This approach:

• Uses the official Docker Hub image
• Properly handles JSON escaping via environment variables
• Provides a more reliable configuration method

Option 2: Building the Docker image locally:

You can also build and run the Docker image locally. First, build the Docker image:

docker-compose build

Then, add the following to your .cursor/mcp.json or claude_desktop_config.json:

{
  "mcpServers": {
    "notionApi": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "OPENAPI_MCP_HEADERS={\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\"}",
        "notion-mcp-server"
      ]
    }
  }
}

Don't forget to replace ntn_**** with your integration secret. Find it from your integration configuration tab:

Installing via Smithery

To install Notion API Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @makenotion/notion-mcp-server --client claude

Examples

1. Using the following instruction

Comment "Hello MCP" on page "Getting started"

AI will correctly plan two API calls, v1/search and v1/comments, to achieve the task

2. Similarly, the following instruction will result in a new page named "Notion MCP" added to parent page "Development"

Add a page titled "Notion MCP" to page "Development"

3. You may also reference content ID directly

Get the content of page 1a6b35e6e67f802fa7e1d27686f017f2

Development

Build

npm run build

Execute

npx -y --prefix /path/to/local/notion-mcp-server @notionhq/notion-mcp-server

Publish

npm publish --access public