# Notion

MCP-сервер для Claude Code подключает ИИ-агента к рабочим пространствам Notion: ищет и читает страницы, меняет их содержимое. Работает с заметками и базами данных из чата.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 у репозитория
- Автор: foreverworks
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/foreverworks/mcps/tree/HEAD/servers/notion
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/foreverworks-notion

## Что делает

Сервер помогает искать страницы, читать их в формате Markdown и работать с базами данных: например, считать записи по значениям столбца или открывать сохранённые представления. Агент также может создавать страницы и записи, редактировать содержимое и свойства, оставлять комментарии и загружать файлы. Изменения затрагивают само рабочее пространство Notion.

Для подключения нужны Node 22.19 или новее, токен для каждого рабочего пространства и папка с файлами токенов. Интеграция видит только страницы, которыми с ней поделились; без доступа к нужной странице агент не сможет с ней работать. Для скачивания файлов дополнительно задают `NOTION_OUTBOX_DIR`, а размер загружаемого файла ограничен 20 MiB или 5 MiB на тарифе Notion Free.

Установите пакет через `npx` и задайте `NOTION_TOKENS_DIR`. Этот MCP-сервер доступен также в Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed и Gemini CLI.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `NOTION_TOKENS_DIR` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.
- Работает с: Notion

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add notion -e NOTION_TOKENS_DIR=<NOTION_TOKENS_DIR> -- npx -y @foreverworks/mcp-notion
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add notion --env NOTION_TOKENS_DIR=<NOTION_TOKENS_DIR> -- npx -y @foreverworks/mcp-notion
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "notion": {
            "command": "npx",
            "args": [
                "-y",
                "@foreverworks/mcp-notion"
            ],
            "env": {
                "NOTION_TOKENS_DIR": "<NOTION_TOKENS_DIR>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "notion": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@foreverworks/mcp-notion"
            ],
            "env": {
                "NOTION_TOKENS_DIR": "<NOTION_TOKENS_DIR>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e NOTION_TOKENS_DIR=<NOTION_TOKENS_DIR> notion npx -y @foreverworks/mcp-notion
```
Вместо <…> подставьте свои значения

## Когда брать
- найти нужную страницу в рабочем пространстве Notion
- посчитать записи базы данных по значениям столбца
- добавить страницу или запись в базу данных
- изменить текст страницы или её свойства
- скачать вложения в заданную папку

## Примеры запросов агенту
- Найди страницу с дорожной картой в рабочем пространстве work и кратко перескажи её.
- Посчитай записи в базе Tasks по каждому значению столбца Status.
- Добавь книгу в базу Reading List со статусом To read и тегом Books.

## Похожие
- [notion-automation](https://affpapa.org/nevibecode/skills/notion-automation.md) — скилл · 5000 установок
- [notion-mcp](https://affpapa.org/nevibecode/skills/notion-mcp.md) — скилл · 878 установок
- [notion-knowledge-capture](https://affpapa.org/nevibecode/skills/notion-knowledge-capture-2.md) — скилл · 612 установок
- [pp-notion](https://affpapa.org/nevibecode/skills/pp-notion.md) — скилл · 394 установки
- [notion-research-documentation](https://affpapa.org/nevibecode/skills/notion-research-documentation-2.md) — скилл · 390 установок
- [notion-sdk](https://affpapa.org/nevibecode/skills/notion-sdk.md) — скилл · 133 установки

## Другие версии с тем же именем
- [Notion · ](https://affpapa.org/nevibecode/mcp/notion.md) — 3841 установка
- [Notion · makenotion](https://affpapa.org/nevibecode/mcp/makenotion-notion.md)
- [Notion · ](https://affpapa.org/nevibecode/mcp/docker-notion.md)

Из того же набора: [foreverworks/mcps](https://affpapa.org/nevibecode/by/foreverworks/mcps.md) — 15 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
