Notion MCP Server
Официальный локальный MCP-сервер для Notion API: поиск, чтение и правка страниц в Markdown, работа с базами данных
Установка
{
"mcpServers": {
"notionApi": {
"command": "npx",
"args": ["-y", "@notionhq/notion-mcp-server"],
"env": {
"NOTION_TOKEN": "ntn_****"
}
}
}
}Тот же фрагмент подходит для .cursor/mcp.json.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер открывает агенту Notion API через токен внутренней интеграции. Агент ищет страницы, читает и переписывает их содержимое в Markdown, что заметно экономит токены по сравнению с JSON-блоками. Доступны запросы к источникам данных с фильтрами и сортировкой, создание и изменение источников, работа с шаблонами и перенос страниц. Удалять базы через сервер нельзя, а права можно сузить до чтения в настройках интеграции.
Для кого. Для команд и специалистов, которые ведут документацию, задачи и базы знаний в Notion.
Подходит, если
- Нужно найти и сводить информацию из базы знаний в Notion
- Нужно обновлять статусы задач в базе данных Notion
- Нужно сгенерировать страницу по шаблону из кода или заметок
Не подходит, если
- Нужна простая установка без токенов: лучше удаленный Notion MCP с OAuth
- Рабочее пространство содержит данные, которые нельзя показывать модели
Пример запроса к агенту
Найди в Notion страницу с планом релиза и добавь в конец раздел с итогами сегодняшней встречиОграничения
Notion развивает удаленный MCP-сервер, а этот репозиторий поддерживается слабо и может быть закрыт. Нужен токен внутренней интеграции, и страницы надо явно открыть интеграции. Версия 2.0 заменила инструменты баз данных на инструменты источников данных. Notion из России работает с ограничениями, доступность API без VPN не гарантирована.
Как отключить. Удалите блок notionApi из конфигурации MCP и отзовите токен интеграции в настройках Notion.
MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| NOTION_TOKEN обязательная, секрет | Токен внутренней интеграции Notion |
| OPENAPI_MCP_HEADERS секрет | JSON с заголовками Authorization и Notion-Version вместо NOTION_TOKEN |
Проверка безопасности
- Изменяет страницы и базы данных рабочего пространства
- Открывает модели содержимое подключенных страниц
Коротко о README
README предупреждает, что основное внимание Notion перенесено на удаленный сервер с OAuth. Описаны изменения версии 2.0 и инструменты для Markdown, пошаговая настройка интеграции и доступа к страницам, конфигурации через npx и Docker для Cursor, Claude Desktop, Zed и Copilot CLI. Есть режим Streamable HTTP с обязательным bearer-токеном. Лицензия MIT.
Частые вопросы
Почему агент не видит страницы?
Страницы и базы нужно подключить к интеграции на вкладке доступа или через меню страницы.
Можно ли дать только чтение?
Да, оставьте у интеграции только право чтения содержимого.
Похожие
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI
Официальные плагины Anthropic для офисных ролей: продажи, поддержка, продукт, маркетинг, юристы, финансы, данные и поиск по компании