Работа с инструментом — Notion
Как устроена команда Notion CLI, вывод для скриптов и подключение агента через навык или MCP.
Здесь объясняется, как устроена команда и как агент работает с инструментом. Прочитайте это перед первой командой.
Сначала профиль
Профилем называется имя, которое вы выбираете для одного аккаунта. Оно стоит первым словом в каждой команде, которой нужен аккаунт:
notion personal config showWCNOTION_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 останавливает его.