easy-notion — MCP-сервер для Claude Code: Notion в markdown
MCP-сервер, который даёт агенту доступ к Notion через обычный markdown. Пригодится, когда страницы нужно читать и править, не разбирая сырой JSON.
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Что делает 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-инструментов.
Какие задачи решает
- прочитать страницу Notion и вернуть её как markdown
- создать страницу с вложенными блоками из markdown-файла
- переписать страницу, сохранив форматирование
- загрузить файл в Notion по пути
file:///path - дать агенту доступ к Notion только на чтение
Примеры запросов агенту
- Прочитай страницу Notion и покажи её содержимое как markdown
- Создай в Notion страницу из файла
notes.md - Обнови страницу Notion: замени текст в первом разделе на новый
Как установить easy-notion
Командой платформы
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 mcp add easy-notion --env NOTION_TOKEN=<NOTION_TOKEN> --env NOTION_ROOT_PAGE_ID=<NOTION_ROOT_PAGE_ID> -- npx -y easy-notion-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"easy-notion": {
"command": "npx",
"args": [
"-y",
"easy-notion-mcp"
],
"env": {
"NOTION_TOKEN": "<NOTION_TOKEN>",
"NOTION_ROOT_PAGE_ID": "<NOTION_ROOT_PAGE_ID>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"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 mcp add -e NOTION_TOKEN=<NOTION_TOKEN> -e NOTION_ROOT_PAGE_ID=<NOTION_ROOT_PAGE_ID> easy-notion npx -y easy-notion-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о easy-notion
Как установить easy-notion в Claude Code?
Выполните claude mcp add easy-notion -e NOTION_TOKEN=<NOTION_TOKEN> -- npx -y easy-notion-mcp. Токен интеграции Notion подставьте свой, страницы заранее откройте этой интеграции.
Что делает easy-notion?
Связывает агента с Notion: markdown на входе превращается в блоки Notion, а страницы читаются обратно в markdown. Всего доступно 43 инструмента и 24 типа блоков.
Чем easy-notion отличается от официального MCP-сервера Notion?
Официальный отдаёт сырой JSON блоков, а easy-notion — обычный markdown. Поэтому чтение страницы стоит меньше токенов, и агенту не приходится собирать блоки заново.
