Úsalo — Notion
Cómo se forma un comando de Notion CLI, la salida para scripts y cómo conectar un agente con skill o MCP.
Aquí se explica cómo se construye un comando y cómo usa un agente la herramienta. Léelo antes de tu primer comando.
Primero el perfil
Un perfil es un nombre que eliges para una cuenta. Es la primera palabra de cada comando que usa una cuenta:
notion personal config showWCNOTION_PROFILE=personal hace lo mismo durante una sesión de la shell. Nunca se supone un perfil, ni siquiera el
único: un comando sin perfil se detiene con el código de salida 2 y muestra los perfiles de este ordenador.
Salida para scripts
Todos los comandos salvo mcp serve sobre stdin y stdout admiten --json e imprimen un único valor JSON en stdout.
Los errores salen en JSON por stderr, con un código para decidir qué hacer. La
referencia de comandos lista los códigos.
Agentes
notion skill install pone la skill de la herramienta donde la buscan Claude Code, Codex, Gemini CLI y OpenClaw.
notion skill install --for hermes además añade esa carpeta a los ajustes de Hermes Agent, así que un
skill install sin más deja fuera a Hermes. notion personal mcp serve sirve los comandos del perfil por MCP, sobre
stdin y stdout:
claude mcp add notion -- notion personal mcp serveEl servidor ofrece todos los comandos, también los que escriben. Los permisos del perfil deciden qué se ejecuta. Consulta los ajustes.
Para ChatGPT y Claude en el navegador,
notion personal mcp serve --http --public-url https://laptop.example.ts.net escucha en 127.0.0.1 (puerto 8765, o
--port) detrás de tu propio túnel. Una aplicación del navegador inicia sesión con un código de un solo uso que
imprime el comando. notion personal mcp revoke cierra todas las sesiones. notion personal mcp server start ejecuta
el mismo servidor en segundo plano, mcp server status muestra su puerto, el código de inicio de sesión y las
aplicaciones conectadas, y mcp server stop lo detiene.