# easy-notion

MCP-сервер, который даёт агенту доступ к Notion через обычный markdown. Пригодится, когда страницы нужно читать и править, не разбирая сырой JSON.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 55
- Автор: Grey-Iris
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/Grey-Iris/easy-notion-mcp
- Обновлён: 2026-09-11
- HTML: https://affpapa.org/nevibecode/mcp/easy-notion

## Что делает

Агент пишет markdown, сервер сам переводит его в блочный API Notion и обратно. Внутри 43 инструмента и поддержка 24 типов блоков: переключатели, колонки, врезки, уравнения, встраивания, таблицы, загрузка файлов, списки задач. Ответы на чтение страницы обходятся заметно дешевле по токенам, чем у официального сервера Notion, потому что в них нет служебных полей каждого блока — идентификаторов, отметок времени, объектов автора. Экономия идёт именно за счёт этого, а не за счёт формата.

Установка идёт через `npx`, отдельный токен Notion нужен в любом случае. Создайте интеграцию в Notion, скопируйте токен и откройте ей доступ к нужным страницам — без этого сервер не увидит ничего. В Claude токен передаётся флагом `-e` и остаётся в конфиге, оболочка и rc-файлы не трогаются. Для `create_page` можно задать родительскую страницу через `NOTION_ROOT_PAGE_ID`.

Есть CLI-профили: они держат отдельные интеграции под разные режимы доступа, например только чтение и чтение с записью, и хранят имена переменных окружения вместо самих токенов. Профили лежат в `~/.config/easy-notion-mcp/profiles.json`. Такой режим выручает, когда агенту нужен Notion без загрузки всего набора MCP-инструментов.

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

## Установка

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

**Командой платформы**
```bash
claude mcp add --env NOTION_TOKEN=<NOTION_TOKEN> --env NOTION_ROOT_PAGE_ID=<NOTION_ROOT_PAGE_ID> --transport stdio easy-notion -- npx -y easy-notion-mcp
```
Вместо <…> подставьте свои значения

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

## Когда брать
- прочитать страницу Notion и вернуть её как markdown
- создать страницу с вложенными блоками из markdown-файла
- переписать страницу, сохранив форматирование
- загрузить файл в Notion по пути `file:///path`
- дать агенту доступ к Notion только на чтение

## Примеры запросов агенту
- Прочитай страницу Notion и покажи её содержимое как markdown
- Создай в Notion страницу из файла `notes.md`
- Обнови страницу Notion: замени текст в первом разделе на новый

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 386989
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119160
- [Codebase Memory](https://affpapa.org/nevibecode/mcp/codebase-memory.md) — MCP-сервер · ★ 47392
- [mcp-server](https://affpapa.org/nevibecode/mcp/mcp-server.md) — MCP-сервер · ★ 43872

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