notion-mcp-server

notion-mcp-server — MCP-сервер сообщества (автор — awkoy). Notion по токену: страницы, базы, блоки, комментарии и файлы. Ставится через npx. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
awkoy
Лицензия
MIT
Транспорт
stdio
Авторизация
token_env
ОС
linux, macos, windows
Языки
typescript

Уровень риска: high

Читает и изменяет страницы и базы Notion, включая удаление; загружает локальные файлы. Есть режим только чтения.

Настройка клиентов

codex
{
    "code": "[mcp_servers.notion]\ncommand = \"npx\"\nargs = [\"-y\", \"notion-mcp-server\"]\nenv = { NOTION_TOKEN = \"ntn_paste_your_token_here\" }",
    "file": "~/.codex/config.toml",
    "lang": "toml",
    "notes": "Дословно из README",
    "verified": "docs"
}

Что умеет

notion-mcp-server — MCP-сервер, который даёт Claude Code, Claude Desktop, Cursor, VS Code, Codex и другим MCP-клиентам доступ к Notion на чтение и запись по одному токену. Агент ищет, создаёт и редактирует страницы, делает выборки из баз данных, оставляет комментарии и загружает файлы — по запросам на обычном языке.

Главное по README:

  • Три инструмента — notion_read, notion_write и notion_describe. При подключении они занимают около 1000 токенов против 17 000 у открытого сервера Notion, а прочитанные страницы возвращаются на 82% компактнее.
  • Авторизация по токену на любом тарифе Notion, включая бесплатный. Вход через браузер не нужен, поэтому сервер работает и без интерфейса: в CI, cron-задачах, фоновых агентах и на своём сервере.
  • Сделан для агентов. Пакетная запись с атомарным откатом и ключами идемпотентности, повтор при ограничении частоты запросов, Markdown на входе и выходе, ошибки с подсказками, как исправить вызов.
  • Файлы и изображения. upload_file принимает base64, публичную ссылку или локальный путь; модель может получить картинку со страницы и разобрать её.

Примеры запросов: найти просроченные задачи в базе Tasks, переименовать 50 страниц одним пакетным вызовом, создать страницу из шаблона, переписать спецификацию, прокомментировать заметки встречи.

Кому подойдёт

  • Командам, ведущим задачи и документацию в Notion, которым нужен агент с правом записи.
  • Автоматизаторам: работа без интерфейса в CI и по расписанию.
  • Пользователям тарифов без MCP-токенов Notion, где официальный хостинговый коннектор в фоновом режиме недоступен.

Похожие серверы — в категории продуктивность.

Установка

  1. Создайте токен на странице app.notion.com/developers/tokens («New token») и скопируйте значение, начинающееся с ntn_. Личный токен видит всё, что видите вы; внутренняя интеграция видит только страницы, к которым её явно подключили.
  2. Установите сервер командой npx add-mcp notion-mcp-server --env NOTION_TOKEN=ntn_paste_your_token_here — она найдёт MCP-клиенты на машине и запишет конфиг. Не убирайте флаг --env, иначе все вызовы будут падать с ошибкой авторизации.

Для Claude Code есть плагин: /plugin marketplace add awkoy/notion-mcp-server, затем /plugin install notion-mcp-server@awkoy (нужен Node.js 22+). Для Gemini CLI — gemini extensions install https://github.com/awkoy/notion-mcp-server. Для Claude Desktop есть пакет .mcpb, Node.js для него не нужен. Режим HTTP включается переменной MCP_TRANSPORT=http.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "notion-mcp-server"],
      "env": { "NOTION_TOKEN": "ntn_paste_your_token_here" }
    }
  }
}

JSON-блок подходит для claude_desktop_config.json в Claude Desktop и ~/.cursor/mcp.json в Cursor. Конфиг Codex кладётся в ~/.codex/config.toml. Замените значение токена на своё.

Проверка

В новом чате попросите: «Создай в Notion страницу “Привет от агента” и добавь чек-лист из трёх пунктов». Агент вызовет notion_write и вернёт ссылку на страницу.

Примеры задач

Найди в базе Tasks все строки со статусом «В работе» и скажи, какие просрочены.
Оставь комментарий к вчерашним заметкам встречи с кратким итогом.

Риски

  • Запись в аккаунт Notion. Сервер создаёт, меняет, архивирует и удаляет страницы и базы. Ограничьте права: NOTION_READ_ONLY=true отключает запись, NOTION_BLOCKED_OPERATIONS=destructive запрещает удаления, а NOTION_CONFIRM_DESTRUCTIVE=true спрашивает подтверждение.
  • Токен. Личный токен видит всё, что видите вы. Храните NOTION_TOKEN в переменных окружения; токен можно отозвать в любой момент.
  • Локальные файлы. upload_file читает файлы с диска; задайте NOTION_UPLOAD_ROOT, чтобы ограничить папку. По умолчанию по stdio отклоняются скрытые и системные пути.
  • HTTP-режим. Открывайте его наружу только с MCP_AUTH_TOKEN и TLS.

Частые вопросы

Чем отличается от официального сервера Notion?

Хостинговый сервер Notion работает через OAuth, а без интерфейса — только на тарифах Business и Enterprise; открытый сервер Notion объявлен устаревшим. Этот сервер работает по токену на любом тарифе.

Можно ли сделать доступ только на чтение?

Да, переменной NOTION_READ_ONLY=true или NOTION_ALLOWED_OPERATIONS=read.

Нужен ли Node.js?

Для npx — да; пакет .mcpb для Claude Desktop и Docker-образ работают без него.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

Memory

Эталонный сервер постоянной памяти на основе графа знаний.

Риск: high Лицензия: NOASSERTION ★ 92 089

Context7

Context7 даёт агентам актуальную документацию и примеры кода библиотек нужных версий.

Риск: medium Лицензия: MIT ★ 65 087

hindsight

Долговременная память для ИИ-агентов по образцу человеческой.

Риск: medium Лицензия: MIT ★ 61 836

cognee-mcp

Менеджер памяти cognee для ИИ-приложений на графовых и векторных хранилищах.

Риск: high Лицензия: Apache-2.0 ★ 33 236

Источники