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, включая удаление; загружает локальные файлы. Есть режим только чтения.
Настройка клиентов
{
"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, где официальный хостинговый коннектор в фоновом режиме недоступен.
Похожие серверы — в категории продуктивность.
Установка
- Создайте токен на странице app.notion.com/developers/tokens («New token») и скопируйте значение, начинающееся с
ntn_. Личный токен видит всё, что видите вы; внутренняя интеграция видит только страницы, к которым её явно подключили. - Установите сервер командой
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
Эталонный сервер постоянной памяти на основе графа знаний.
Context7
Context7 даёт агентам актуальную документацию и примеры кода библиотек нужных версий.
hindsight
Долговременная память для ИИ-агентов по образцу человеческой.
cognee-mcp
Менеджер памяти cognee для ИИ-приложений на графовых и векторных хранилищах.