Notion MCP

Что умеет сервер

Notion MCP размещён у Notion. После авторизации через OAuth клиент работает с содержимым, к которому у вас есть доступ. Набор инструментов включает поиск по страницам и базам, а также по подключённым источникам, получение страницы, создание и обновление страниц, перемещение и дублирование, создание баз данных и представлений, запросы к источникам данных, комментарии и загрузку файлов.

Инструменты можно комбинировать в одной задаче: найти страницы, собрать из них новую и обновить свойства. Кроме того, документация упоминает чтение расписаний и управление событиями в подключённых календарях.

Когда использовать

Сервер подходит, когда база знаний, задачи или заметки живут в Notion, а агенту нужно искать в них ответы, наполнять базы по результатам разговора или превращать черновики в оформленные страницы. Типичные клиенты: Claude Code, Cursor и Codex.

Прежний открытый сервер makenotion/notion-mcp-server, который запускается локально через npm с интеграционным токеном, его авторы больше не поддерживают активно и рекомендуют перейти на удалённый вариант. Для новых подключений берите удалённый.

Ограничения и безопасность

Агент действует с правами подключившегося пользователя: он видит и может менять всё, что доступно этому пользователю в выбранном рабочем пространстве. Владельцы рабочего пространства управляют разрешёнными MCP-клиентами в настройках Notion MCP, а ограничение списка клиентов для участников доступно на тарифе Enterprise. Для подключений, принадлежащих рабочему пространству, администратор выбирает, какие именно инструменты будут доступны.

Некоторые инструменты изменяют или удаляют данные (удаление страниц и баз, перемещение), поэтому включайте подтверждение вызовов в клиенте и проверяйте, какие страницы затрагивает запрос.

Claude Code

claude mcp add --transport http notion https://mcp.notion.com/mcp

Затем выполните /mcp в Claude Code и пройдите вход через OAuth. Флаг --scope задаёт область: local (по умолчанию, только вы в текущем проекте), project (общий файл .mcp.json), user (все ваши проекты).

Cursor

Создайте файл .cursor/mcp.json в корне проекта (или ~/.cursor/mcp.json для всех проектов):

{
  "mcpServers": {
    "notion": {
      "url": "https://mcp.notion.com/mcp"
    }
  }
}

Затем откройте Customize в боковой панели Cursor, включите Notion и пройдите вход через OAuth.

VS Code (GitHub Copilot)

Создайте файл .vscode/mcp.json в рабочей папке:

{
  "servers": {
    "notion": {
      "type": "http",
      "url": "https://mcp.notion.com/mcp"
    }
  }
}

Откройте палитру команд (Ctrl+Shift+P или Cmd+Shift+P), выполните MCP: List Servers, запустите сервер Notion и пройдите вход.

Codex

Добавьте в ~/.codex/config.toml:

[mcp_servers.notion]
url = "https://mcp.notion.com/mcp"

Затем выполните вход:

codex mcp login notion

Antigravity

Добавьте в mcp_config.json:

{
  "mcpServers": {
    "notion": {
      "serverUrl": "https://mcp.notion.com/mcp"
    }
  }
}

Для Devin, Hermes, Pi и fx в документации Notion есть отдельные инструкции, здесь они не приводятся. Адрес сервера везде один: https://mcp.notion.com/mcp.