Сервер Notion MCP

понятие-mcp-sm

В этом проекте реализован MCP-сервер для Notion API .

mcp-демо

Установка

1. Настройка интеграции в Notion:

Перейдите по ссылке https://www.notion.so/profile/integrations и создайте новую внутреннюю интеграцию или выберите существующую.

Создание токена интеграции Notion

Хотя мы ограничиваем область действия Notion API (например, вы не сможете удалять базы данных через MCP), существует ненулевой риск для данных рабочей области, если они будут раскрыты LLM. Пользователи, заботящиеся о безопасности, могут захотеть дополнительно настроить возможности интеграции.

Например, вы можете создать токен интеграции, доступный только для чтения, предоставив доступ только «Чтение содержимого» на вкладке «Конфигурация»:

Возможности токена интеграции Notion, показывающие, что прочитанное содержимое отмечено

2. Подключение контента к интеграции:

Убедитесь, что к вашей интеграции подключены соответствующие страницы и базы данных.

Для этого вам необходимо зайти на эту страницу, нажать на три точки и выбрать «Подключиться к интеграции».

Добавление интеграционного токена к соединениям Notion

3. Добавление конфигурации MCP в ваш клиент:

Использование npm:

Добавьте следующее в ваш .cursor/mcp.json или 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\" }"
      }
    }
  }
}

Использование Докера:

Существует два варианта запуска сервера MCP с Docker:

Вариант 1: Использование официального образа Docker Hub:

Добавьте следующее в ваш .cursor/mcp.json или 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\"}"
      }
    }
  }
}

Этот подход:

Использует официальный образ Docker Hub
Правильно обрабатывает экранирование JSON через переменные среды.
Обеспечивает более надежный метод настройки

Вариант 2: Локальная сборка образа Docker:

Вы также можете создать и запустить образ Docker локально. Сначала создайте образ Docker:

docker-compose build

Затем добавьте следующее в ваш .cursor/mcp.json или 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"
      ]
    }
  }
}

Не забудьте заменить ntn_**** на ваш секрет интеграции. Найдите его на вкладке конфигурации интеграции:

Копирование токена интеграции из вкладки «Конфигурация» на портале разработчика

Примеры

Используя следующую инструкцию

Comment "Hello MCP" on page "Getting started"

ИИ правильно спланирует два вызова API, v1/search и v1/comments , для выполнения задачи

Аналогично, следующая инструкция приведет к созданию новой страницы с именем «Notion MCP», добавленной к родительской странице «Разработка».

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

Вы также можете ссылаться на идентификатор контента напрямую.

Get the content of page 1a6b35e6e67f802fa7e1d27686f017f2

Разработка

Строить

npm run build

Выполнять

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

Публиковать

npm publish --access public

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Сервер MCP, который позволяет помощникам на основе искусственного интеллекта взаимодействовать с API Notion, что позволяет им искать, читать, комментировать и создавать контент в рабочих пространствах Notion с помощью команд на естественном языке.

Related MCP Servers

Notion MCP Server
suekou
A
security
A
license
A
quality
MCP Server for the Notion API, enabling Claude to interact with Notion workspaces.
Last updated -
18
1,230
699
TypeScript
MIT License
SystemPrompt MCP Notion Server
Ejb503
A
security
F
license
A
quality
A high-performance MCP server that integrates Notion into AI workflows, enabling interaction with Notion pages, databases, and comments through a standardized protocol.
Last updated -
8
10
13
TypeScript
Notion MCP Server
ramidecodes
A
security
A
license
A
quality
A Model Context Protocol (MCP) server that exposes the official Notion SDK, allowing AI models to interact with Notion workspaces.
Last updated -
17
77
7
TypeScript
Apache 2.0
notion-mcp-server
awkoy
A
security
A
license
A
quality
Notion MCP Server is a MCP server implementation that enables AI assistants to interact with Notion's API.
Last updated -
13
194
91
TypeScript
MIT License

View all related MCP servers

Notion MCP Server