Notion
Historial de cambios — Notion
Funciones publicadas de Notion CLI: inicio de sesión, lectura en directo, copia local, sincronización y búsqueda.
Cambios destacados de @wirecat/notion-cli. Una sección por versión, la más reciente primero.
0.2.0 — 16.11.2026
Novedades
notion <profile> synccopia las páginas de Notion, las páginas dentro de páginas, las bases de datos y sus filas al almacén compartido de WireCat, con el proveedornotion. Sin una carpeta elegida copia todo lo que ve el token.--limitacota una ejecución y--rescanvuelve a recorrerlo todo. Una página o base de datos que Notion no entregó se nombra enmeta.issuesy en loswarningsde la respuesta. Entonces la respuesta indicameta.complete: falsey sale con 0. Un recorrido demasiado largo para una ejecución se detiene a tiempo y la siguiente sincronización continúa. El tamaño de las carpetas elegidas no tiene límite. Un bloque dentro de una página cuyos hijos Notion no entrega (un bloque sincronizado cuyo original no está compartido) se omite con un aviso. Una página o base de datos a la que Notion responde 403 se queda como estaba. Solo un 404 o la papelera la eliminan. Un bloque que Notion rechaza en el Markdown de una página, o una fuente de datos que no deja consultar, se omite con un aviso y el resto se sincroniza. Consulta la sincronización.- Una sincronización dura hasta 15 minutos en una terminal y 45 segundos por MCP, salvo que
--timeoutfije otro tiempo (cli-core 0.671.0). Se detiene antes de su plazo, tanto en la pasada de cada hora como en el recorrido diario, petición a petición. Guarda dónde se detuvo, respondecomplete: falsey nombrasynccomo el siguiente paso. Las páginas hijas de una página salen de su listado, 100 por petición. Un--timeoutdemasiado corto para guardar algo falla contimeouty el motivonotion.timeout-too-short. Consulta la sincronización. - Una conexión de Notion es un perfil.
session startysyncrechazan una conexión que usa otro perfil con la sesión iniciada, y un perfil sincronizado desde una conexión rechaza el token de otra. Un perfil que inició sesión conWCNOTION_TOKENtambién cuenta. Consulta el inicio de sesión. - Las páginas dentro de páginas, y una página como carpeta elegida, ya se sincronizan. La 0.1.0 decía que aún no estaban hechas.
folders add|list|browse|removeacotan la sincronización a las páginas y bases de datos elegidas.folders browselista un nivel en directo desde Notion. Al quitar la última carpeta, el comando avisa de que la siguiente sincronización vuelve a copiar todo el espacio de trabajo. Por MCP,folders addpasa por la herramienta de escritura.status,documents list|show|export|context|add,search(sintaxis de Lucene, sin conexión),catalog,tags,relationships,notes,memories,factseidentities: los comandos de documentos compartidos de cli-core sobre la copia local.documents addguarda una página, leída en directo, entre las fuentes añadidas a mano.
Corregido
- Una primera sincronización de una base de datos grande, o de una página con muchas páginas hijas, avanza en cada
ejecución, también dentro de los 45 segundos de MCP. La sincronización lista una carpeta página a página y continúa
donde se detuvo (
childrenPagede cli-core). Antes, una base de datos de más de unas 12.000 filas detenía la primera sincronización por MCP en el mismo paso en cada ejecución. Consulta la sincronización. - Las consultas a bases de datos se ajustan al límite documentado de Notion, unas 3 peticiones por segundo, no 60 por minuto. Consulta el diseño.
folders browse --parenty la copia sincronizada dan a una página dentro de otra su enlace, en la forma propia de Notionhttps://app.notion.com/p/{page-id}, en lugar de unurlvacío. Consulta la sincronización.
0.1.0 — 15.11.2026
Novedades
- Creado a partir de
@wirecat/cli-template0.24.0. api: toda la API pública de Notion, un comando por operación. Las 61 operaciones del documento OpenAPI de Notion son comandos,notion personal api retrieve-a-page --page-id …, cada uno con su propia clave de permiso,api.<operation>.api listyapi show <operation>leen el documento guardado sin llamar a Notion. Cada petición llevaNotion-Version2026-03-11, así que ningún comando la pide. Una operación que borra pregunta antes en una terminal. Por MCP,askla deja pasar, así que pon su clave endenypara frenar a un agente.--dry-runno envía nada. No se ofrecen las operaciones de tokens OAuth ni las dos subidas de archivos. Las primeras inician sesión con el secreto de cliente de la conexión y llevan tokens, las segundas envían cuerpos multipart. Las comprobaciones aceptan algo más que Notion: cualquier valor JSON queda sin tipo, y tres límites (exclusiveMinimum,exclusiveMaximum,maxProperties) se omiten en seis sitios, así que es Notion quien rechaza lo que los incumple. Cobertura.session start | status | end | listcon un token de acceso personal de Notion o el token de una conexión interna. Se comprueba con Notion y se guarda en el llavero comotoken:<profile>. La cuenta es el espacio de trabajo y el bot del token.documents getlee una página en directo como Markdown, completa las partes que faltan de una página larga y quita la firma de los enlaces firmados de Notion a archivos. Una página que sigue incompleta respondemeta.complete: falsey sale con un código distinto de cero.databases listydatabases show: las bases de datos que ve el token, y el id y las propiedades de cada fuente de datos.- Las peticiones van por debajo del límite de Notion, más despacio aún para las consultas a fuentes de datos. Tras un
rechazo, la herramienta espera lo que indica el
Retry-Afterde Notion. No se vuelve a intentar con una conexión que Notion ha bloqueado. - Las variables de entorno empiezan por
WCNOTION_(WCNOTION_TOKEN,WCNOTION_PROFILE), no porNOTION_. El propio servidor MCP de Notion leeNOTION_TOKEN, y un token definido para él no debe iniciar sesión en esta herramienta. - Una fuente de sincronización incremental para Notion, lista para el motor de sincronización de cli-core. Lee los cambios desde una marca de tiempo con solapamiento, consulta cada base de datos del alcance, lo recorre todo una vez al día y solo elimina una página cuando Notion confirma que ya no existe. Las bases de datos grandes se leen enteras, más allá del tope de 10.000 filas por consulta de Notion. Un elemento que Notion rechaza se omite con un aviso, y una sincronización interrumpida continúa la próxima vez. Aún no: las páginas dentro de páginas, y una página como carpeta elegida, que esperan a cli-core. Consulta la sincronización.