
Notion MCP
Локальный сервер Notion поверх Notion API: поиск по заголовкам, чтение и правка страниц в Markdown, базы и источники данных, блоки, комментарии и пользователи. Агент видит только страницы, открытые интеграции.
Как подключить
Что сделать до подключения
Node.js с npx
Внутренняя интеграция Notion и доступ к нужным страницам: вкладка Access в настройках интеграции или «⋯ → Connect to integration» на странице
NOTION_TOKENсоздайте внутреннюю интеграцию на notion.so/profile/integrations и скопируйте её токен ntn_…; для режима только чтения оставьте в Capabilities одну галочку Read content
Конфиг для вашего клиента
Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code
claude mcp add --env 'NOTION_TOKEN=ntn_<токен интеграции>' --transport stdio notion \
-- npx -y @notionhq/notion-mcp-serverПроверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.
Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex
[mcp_servers.notion]
command = "npx"
args = ["-y", "@notionhq/notion-mcp-server"]
[mcp_servers.notion.env]
NOTION_TOKEN = "ntn_<токен интеграции>"Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.
Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "@notionhq/notion-mcp-server"],
"env": {
"NOTION_TOKEN": "ntn_<токен интеграции>"
}
}
}
}Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.
Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code
{
"mcpServers": {
"notion": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@notionhq/notion-mcp-server"],
"env": {
"NOTION_TOKEN": "ntn_<токен интеграции>"
}
}
}
}Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.
Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "@notionhq/notion-mcp-server"],
"env": {
"NOTION_TOKEN": "ntn_<токен интеграции>"
}
}
}
}Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.
Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "@notionhq/notion-mcp-server"],
"env": {
"NOTION_TOKEN": "ntn_<токен интеграции>"
}
}
}
}Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.
Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"notion": {
"type": "local",
"command": ["npx", "-y", "@notionhq/notion-mcp-server"],
"environment": {
"NOTION_TOKEN": "ntn_<токен интеграции>"
}
}
}
}
}Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.
Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "@notionhq/notion-mcp-server"],
"env": {
"NOTION_TOKEN": "ntn_<токен интеграции>"
}
}
}
}Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.
Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "@notionhq/notion-mcp-server"],
"env": {
"NOTION_TOKEN": "ntn_<токен интеграции>"
}
}
}
}Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.
Инструменты сервера
API-post-searchищет страницы по заголовкуAPI-retrieve-page-markdownчитает страницу в MarkdownAPI-update-page-markdownправит страницу в MarkdownAPI-post-pageсоздаёт страницуAPI-patch-pageменяет свойства страницыAPI-move-pageпереносит страницуAPI-retrieve-a-pageчитает свойства страницыAPI-get-block-childrenчитает блоки страницыAPI-patch-block-childrenдобавляет блокиAPI-update-a-blockправит блокAPI-delete-a-blockудаляет блокAPI-query-data-sourceвыбирает записи базы с фильтрамиAPI-retrieve-a-data-sourceпоказывает схему базыAPI-create-a-data-sourceсоздаёт базуAPI-update-a-data-sourceменяет свойства базыAPI-list-data-source-templatesперечисляет шаблоны базыAPI-retrieve-a-commentчитает комментарииAPI-create-a-commentоставляет комментарийAPI-get-usersперечисляет пользователейПоказано 19 из 24.
Что попросить агента
Для каких задач
Ограничения
Notion больше не развивает и не поддерживает этот репозиторий и советует перейти на удалённый Remote Notion MCP
Поиск идёт только по ключевым словам в заголовках, без семантического поиска
Доступ выдаётся вручную: каждую страницу или базу нужно подключить к интеграции
Удалять базы через сервер нельзя, но правка и удаление блоков доступны; для защиты выдайте интеграции только чтение