better-notion-mcp — MCP-сервер для Claude Code: Notion в Markdown
Даёт агенту доступ к страницам, базам, блокам и комментариям Notion, принимая и возвращая Markdown вместо сырых JSON-блоков.
claude mcp add better-notion-mcp -e NOTION_TOKEN=<NOTION_TOKEN> -- npx -y @n24q02m/better-notion-mcpЧто делает better-notion-mcp
Сервер снимает типовую боль работы с Notion через API: вместо цепочки атомарных запросов агент делает один вызов. Внутри 8 составных инструментов и 39 действий — страницы, базы, блоки, комментарии. Контент приходит и уходит в Markdown, и модели проще его читать.
Пагинация и массовые операции уже встроены, курсор перебирать вручную не нужно. Описания инструментов сжаты, а подробности агент запрашивает через отдельный help по мере надобности: расход токенов падает примерно на 77%. Пакет называется @n24q02m/notion; прежнее имя @n24q02m/better-notion-mcp и команда better-notion-mcp пока работают как алиас.
Режимов подключения два: локальный stdio с токеном интеграции либо удалённый HTTP с OAuth 2.1, где токен вставлять не надо. Для stdio нужен Node.js 24 или новее — на более старой версии npx пакет не поднимет. Токен берётся в настройках интеграций Notion по адресу https://www.notion.so/my-integrations и начинается с ntn_.
Какие задачи решает
- прочитать страницу Notion и отдать её содержимое в Markdown
- добавить запись в базу из текста, который написал агент
- обойти длинный список блоков без самодельных циклов пагинации
- собрать все комментарии к странице одним вызовом
- залить пачку строк в базу массово
Примеры запросов агенту
- Найди в Notion страницу с заметками о релизе и перепиши раздел про миграции в Markdown.
- Создай в базе задач запись про падение авторизации и добавь комментарий со ссылкой на лог.
- Выгрузи все блоки страницы
Roadmapи собери из них черновик резюме.
Как установить better-notion-mcp
Командой платформы
claude mcp add better-notion-mcp -e NOTION_TOKEN=<NOTION_TOKEN> -- npx -y @n24q02m/better-notion-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add better-notion-mcp --env NOTION_TOKEN=<NOTION_TOKEN> -- npx -y @n24q02m/better-notion-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"better-notion-mcp": {
"command": "npx",
"args": [
"-y",
"@n24q02m/better-notion-mcp"
],
"env": {
"NOTION_TOKEN": "<NOTION_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"better-notion-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@n24q02m/better-notion-mcp"
],
"env": {
"NOTION_TOKEN": "<NOTION_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e NOTION_TOKEN=<NOTION_TOKEN> better-notion-mcp npx -y @n24q02m/better-notion-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о better-notion-mcp
Как установить better-notion-mcp в Claude Code?
Одной командой: claude mcp add better-notion-mcp -e NOTION_TOKEN=<NOTION_TOKEN> -- npx -y @n24q02m/better-notion-mcp. Вместо плейсхолдера подставьте токен интеграции Notion, он начинается с ntn_.
Что делает better-notion-mcp?
Работает с Notion в терминах Markdown: страницы, базы, блоки и комментарии. 8 составных инструментов и 39 действий заменяют цепочку атомарных запросов к API.
Нужен ли токен Notion и Node.js?
Для локального stdio нужны оба: Node.js 24 или новее и токен интеграции. В режиме HTTP авторизация идёт через OAuth 2.1, и токен в конфиг вставлять не требуется.
