Notion MCP Server
MCP-сервер для Notion: агент ищет, читает, запрашивает и обновляет страницы и базы рабочего пространства
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Пишет и обновляет реальные страницы и базы Notion
- Работает с токеном доступа к рабочему пространству
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/suekou-mcp-notion-serverОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
У записи высокий риск, поэтому установки в один клик нет. Посмотрите код и добавьте конфиг вручную.
Выполните в терминале
claude mcp add --transport stdio --env 'NOTION_API_TOKEN=<ваш NOTION_API_TOKEN>' notion -- npx -y @suekou/mcp-notion-serverИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"notion": {
"command": "npx",
"args": [
"-y",
"@suekou/mcp-notion-server"
],
"env": {
"NOTION_API_TOKEN": "<ваш NOTION_API_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
NOTION_API_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"notion": {
"command": "npx",
"args": [
"-y",
"@suekou/mcp-notion-server"
],
"env": {
"NOTION_API_TOKEN": "<ваш NOTION_API_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
NOTION_API_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
code --add-mcp '{"name":"notion","type":"stdio","command":"npx","args":["-y","@suekou/mcp-notion-server"],"env":{"NOTION_API_TOKEN":"<ваш NOTION_API_TOKEN>"}}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"notion": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@suekou/mcp-notion-server"
],
"env": {
"NOTION_API_TOKEN": "<ваш NOTION_API_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
NOTION_API_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add notion --env 'NOTION_API_TOKEN=<ваш NOTION_API_TOKEN>' -- npx -y @suekou/mcp-notion-serverИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.notion]
command = "npx"
args = ["-y", "@suekou/mcp-notion-server"]
env = { NOTION_API_TOKEN = "<ваш NOTION_API_TOKEN>" }Если файл уже есть, допишите блок в конец.
Ключи и настройки
NOTION_API_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"notion": {
"command": "npx",
"args": [
"-y",
"@suekou/mcp-notion-server"
],
"env": {
"NOTION_API_TOKEN": "<ваш NOTION_API_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
NOTION_API_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"notion": {
"command": "npx",
"args": [
"-y",
"@suekou/mcp-notion-server"
],
"env": {
"NOTION_API_TOKEN": "<ваш NOTION_API_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Ключи и настройки
NOTION_API_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"notion": {
"command": "npx",
"args": [
"-y",
"@suekou/mcp-notion-server"
],
"env": {
"NOTION_API_TOKEN": "<ваш NOTION_API_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Ключи и настройки
NOTION_API_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"notion": {
"command": "npx",
"args": [
"-y",
"@suekou/mcp-notion-server"
],
"env": {
"NOTION_API_TOKEN": "<ваш NOTION_API_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
NOTION_API_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"notion": {
"type": "local",
"command": [
"npx",
"-y",
"@suekou/mcp-notion-server"
],
"environment": {
"NOTION_API_TOKEN": "<ваш NOTION_API_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
NOTION_API_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"notion": {
"command": "npx",
"args": [
"-y",
"@suekou/mcp-notion-server"
],
"env": {
"NOTION_API_TOKEN": "<ваш NOTION_API_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
NOTION_API_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"notion": {
"command": "npx",
"args": [
"-y",
"@suekou/mcp-notion-server"
],
"env": {
"NOTION_API_TOKEN": "<ваш NOTION_API_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
NOTION_API_TOKENсекрет, обязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавь MCP-сервер: npx -y @suekou/mcp-notion-server и задай переменную NOTION_API_TOKEN с токеном интеграции. Токен пользователь создает сам в панели интеграций Notion.
Другие способы из описания автора
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "@suekou/mcp-notion-server"],
"env": {
"NOTION_API_TOKEN": "your-integration-token"
}
}
}
}Токен создается в панели интеграций Notion.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает агента к API Notion и держит ответы компактными для повседневной работы. Агент ищет страницы и цели через notion_find, читает страницы со стабильными идентификаторами блоков, изучает схему источников данных и делает запросы с учетом схемы, а также создает записи по простым значениям. Есть простые инструменты правки для абзацев, заголовков, списков, задач, цитат, врезок, блоков кода и безопасного добавления Markdown, плюс сырые вызовы API для продвинутых операций с блоками, страницами, базами, комментариями и пользователями. Сервер ориентирован на актуальную модель баз и источников данных Notion и умеет отдавать структурные результаты, промпты и ресурсы, а также опциональные интерактивные приложения.
Для кого. Для команд и специалистов, которые ведут документы и базы в Notion и хотят управлять ими через агента.
Подходит, если
- Нужно, чтобы агент искал и читал страницы Notion
- Нужно делать запросы к базам и создавать записи
- Нужно править страницы или добавлять контент из агента
Не подходит, если
- Нет интеграции Notion и токена
- Нельзя давать агенту доступ к рабочему пространству
Пример запроса к агенту
Найди в Notion базу задач и добавь новую задачу со сроком на пятницуОграничения
Нужен токен внутренней интеграции Notion, а сервер видит только то, что ей выдали. Права на чтение, вставку и обновление контента настраиваются в интеграции, поэтому выдавайте только нужное. Операции обновления меняют реальные страницы и базы.
Как отключить. Удалите сервер notion из конфигурации MCP и при желании отключите интеграцию в Notion.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| NOTION_API_TOKEN обязательная, секрет | Токен внутренней интеграции Notion с нужными правами на чтение, вставку и обновление |
Проверка безопасности
- Пишет и обновляет реальные страницы и базы Notion
- Работает с токеном доступа к рабочему пространству
Коротко о README
README описывает MCP-сервер для API Notion, который помогает агенту искать, читать, запрашивать и обновлять рабочие пространства, держа ответы компактными. Сервер рассчитан на актуальную модель баз и источников данных, дает инструменты правки, сырые вызовы API и опциональные интерактивные приложения. Установка через npx с переменной NOTION_API_TOKEN, есть руководство по созданию интеграции и выдаче прав. Лицензия MIT.
Частые вопросы
Где взять токен?
Создайте внутреннюю интеграцию в панели интеграций Notion и выдайте ей только нужные права на чтение, вставку и обновление.
Может ли сервер менять данные?
Да, при выданных правах он создает и обновляет страницы, блоки и записи баз.
Похожие
Самостоятельно размещаемая база знаний с блочными ссылками и встроенным MCP-сервером для подключения AI-агентов к заметкам
CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие
Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP
Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI