Notion

Работа с инструментом — Notion

Как устроена команда Notion CLI, вывод для скриптов и подключение агента через навык или MCP.

Здесь объясняется, как устроена команда и как агент работает с инструментом. Прочитайте это перед первой командой.

Сначала профиль

Профилем называется имя, которое вы выбираете для одного аккаунта. Оно стоит первым словом в каждой команде, которой нужен аккаунт:

notion personal config show

WCNOTION_PROFILE=personal делает то же самое для одного сеанса оболочки. Профиль никогда не подставляется сам, даже если он единственный: команда без профиля останавливается с кодом выхода 2 и показывает профили на этом компьютере.

Вывод для скриптов

Каждая команда, кроме mcp serve на stdin и stdout, принимает --json и печатает одно значение JSON в stdout. Ошибки выводятся в stderr тоже в JSON, с кодом, по которому можно ветвиться. Справочник команд перечисляет коды.

Агенты

notion skill install кладет навык инструмента туда, где его ищут Claude Code, Codex, Gemini CLI и OpenClaw. notion skill install --for hermes еще и добавляет эту папку в собственные настройки Hermes Agent, так что простой skill install обходится без Hermes. notion personal mcp serve отдает команды профиля по MCP, через stdin и stdout:

claude mcp add notion -- notion personal mcp serve

Сервер предлагает все команды, в том числе те, что пишут. Что запускается, решают разрешения профиля, см. настройки.

Для ChatGPT и Claude в браузере notion personal mcp serve --http --public-url https://laptop.example.ts.net слушает на 127.0.0.1 (порт 8765 или --port) за вашим собственным туннелем. Браузерное приложение входит по одноразовому коду, который печатает команда. notion personal mcp revoke завершает все входы. notion personal mcp server start запускает тот же сервер в фоне, mcp server status показывает его порт, код входа и вошедшие приложения, а mcp server stop останавливает его.