Notion CLI: consulta y revisa tu espacio desde una copia local

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

• Dificultad: intermedio
• Proyecto: https://github.com/mvanhorn/printing-press-library/tree/main/library/productivity/notion
• Guía completa: https://lab.wisd.ai/hub/notion-cli

Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Paso 1: prepara el acceso

Comprueba que tienes Node.js ≥22.20.0 y npm/npx, Go ≥1.26.10 y el directorio de binarios accesible por PATH (metadatos del instalador). Crea una integración interna y comparte con ella las bases de prueba. Guarda su token en la variable privada NOTION_TOKEN para el paso de autenticación.

Paso 2: instala la CLI

El instalador compila con Go; .go-version fija 1.26.10. Node ≥22.20.0 es necesario para la CLI skills invocada tras compilar, aunque el catálogo acepte ≥20. Ejecuta el comando del README:

npx -y @mvanhorn/printing-press-library install notion

Quedan instalados notion-pp-cli y su skill. El directorio por defecto es ~/.local/bin en macOS/Linux o %LOCALAPPDATA%\Programs\PrintingPress\bin en Windows. Si no está en PATH, aplica la línea específica que imprima el instalador y abre una terminal nueva.

Paso 3: autentica y prueba el flujo documentado

Después de instalar, guarda el token con el comando del inicio rápido:

notion-pp-cli auth set-token "$NOTION_TOKEN"

El README usa NOTION_TOKEN como entrada para este comando y NOTION_BEARER_AUTH en su tabla de configuración; esta ruta conserva el token mediante auth set-token.

Ejecuta los comandos en este orden. Los términos, dominios e identificadores de ejemplo se sustituyen por los que correspondan a tu trabajo.

notion-pp-cli sync --full
notion-pp-cli stale --days 30 --json
notion-pp-cli changed --since 7d --json

Comprobación

Comprueba que cada comando termina correctamente y que la salida corresponde a la cuenta, fuente o datos que seleccionaste. Una lista vacía no demuestra que el dato no exista: comprueba primero el alcance de la consulta y, si usas una copia local, su sincronización.

Si algo falla

Si aparece object not found, comprueba que la integración tenga acceso a la base. Si las consultas locales no devuelven datos, completa primero la sincronización. Consulta el README de esta CLI para las opciones específicas de tu sistema y versión. No compartas credenciales en la salida de diagnóstico.