Claude revisará tu ordenador, instalará la herramienta y te avisará cuando tengas que autorizar Todoist en el navegador. Solo tienes que seguirle.
Quiero conectar mi Todoist a Claude Code para que puedas leer, crear y organizar mis tareas. No soy técnico: guíame paso a paso, un paso cada vez, y espera a que te confirme antes de seguir.
CONTEXTO PARA TI
- Doist publica un CLI oficial de Todoist, td, que habla con la API OAuth oficial (la misma que las apps), así que no hay riesgo de bloqueo de cuenta. Necesita conexión a internet, respeta límites de uso y no tiene modo offline.
- Se instala con npm: "npm install -g @doist/todoist-cli". Necesita Node.js. Se comprueba con "td --version".
- Acceso: "td auth login" abre el navegador para autorizar y guarda el token en el gestor de credenciales del sistema. "td auth status" confirma la conexión.
- Comandos útiles: "td today", "td upcoming", "td inbox", "td completed"; "td task add", "td task qa" (quick-add en lenguaje natural), "td task list" (con --filter para cualquier filtro de Todoist, p.ej. "overdue & p1"), "td task complete" (también update, move, reschedule, delete); "td project list", "td label", "td section", "td comment", "td reminder".
- Para leer la salida, usa --json (y --quiet al crear para obtener solo el ID) en vez de parsear el texto con color.
- Los nombres de proyectos y tareas se buscan de forma aproximada y paginada: para algo automatizado, mejor id:xxx o una URL de Todoist.
QUÉ QUIERO QUE HAGAS
1. REVISAR: comprueba tú mismo qué sistema operativo uso y si tengo Node.js y npm. Si falta Node, instálalo pidiéndome permiso antes.
2. INSTALAR: instala td con npm, pidiéndome permiso antes, y verifica con td --version.
3. GUIARME EN EL ACCESO: ejecuta td auth login y dime claramente que autorice en la ventana del navegador que se abre. Espera a que te diga "listo" y confirma con td auth status.
4. TOKEN: nunca me pidas que te pegue una contraseña ni un token en el chat. El acceso se aprueba en el navegador y el token queda en el gestor de credenciales del sistema.
5. PROBAR: ejecuta td today y td inbox y enséñame lo que tengo para hoy, para confirmar que funciona.
6. RECORDAR: crea una skill personal que diga que uso el CLI td para gestionar mi Todoist desde Claude Code, con lo de --json y de usar id:xxx en vez de nombres.
Reglas: no completes, borres, muevas ni reprogrames tareas sin que yo lo pida de forma explícita, y enséñame lo que vas a cambiar antes de hacerlo. Si algo falla, explícamelo en lenguaje sencillo antes de intentar arreglarlo.
CÓMO TRABAJAR CONMIGO
- Explícame cada paso como a un niño de 10 años: frases cortas, sin jerga y, si usas una palabra técnica, dime en una línea qué es. Si te digo que soy técnico, ve al grano.
- Cuando tengas que preguntarme algo, hazlo de una pregunta en una y con opciones para elegir (usa la herramienta de preguntas con opciones si la tienes), con una línea que explique cada opción.
- Si hay que instalar algo, dime en una línea qué es y para qué sirve, y ofrécete a instalarlo tú con mi permiso. Si algo falla, cuéntame en palabras sencillas qué ha pasado y cuál es el siguiente intento, antes de probarlo.
- Lo que te cuento arriba puede haberse quedado viejo. Antes de empezar, comprueba en la documentación oficial que sigue vigente; si algo no coincide, manda la documentación y dime qué ha cambiado.
- Si tienes navegador (el navegador integrado de la app de Claude o Claude in Chrome), hazlo tú todo lo que puedas en vez de mandarme a una web: ábrela tú, navega hasta la pantalla exacta, rellena lo que no sea secreto y léeme lo que haga falta. Si arriba pone que yo vaya a una página o pulse algo, tómalo como lo que hay que conseguir y hazlo tú con el navegador. Pídeme a mí, de un paso en uno, solo lo que no puedes hacer: iniciar sesión, aprobar permisos, pagar o copiar una clave; tú no escribes contraseñas ni claves en ninguna web. Si no tienes navegador, entonces guíame con instrucciones.
- Si hacen falta claves o algo más para conectarte (scripts, configuración), guárdalo en un sitio fijo de mi usuario, fuera de esta carpeta y de cualquier repositorio, que solo yo pueda leer. Nunca en el chat ni dentro de una skill.
- La skill de RECORDAR, hazla personal (que funcione desde cualquier carpeta) y apunta en ella: cómo conectarte, con qué cuenta o usuario, dónde están las claves (el sitio, nunca el valor), qué suelo pedirte, las reglas de arriba y la fecha en que comprobaste la documentación. Si algo deja de funcionar porque el servicio cambió, mira la documentación, arréglalo y actualiza la skill.
- Mis preferencias y lo que haya fallado van en un LEARNINGS.md aparte, en la misma carpeta de esa skill (una línea por aprendizaje, con fecha y el porqué). El primer paso de la skill es leerlo y aplicarlo. Para que nunca se te olvide proponer aprendizajes nuevos al terminar, añade al frontmatter de su SKILL.md este hook, cambiando <nombre-de-la-skill> por su nombre (inyecta un recordatorio una vez por uso; no lo cambies por un bloqueo, que entra en bucle):
hooks:
Stop:
- hooks:
- type: command
once: true
command: |
grep -q '"stop_hook_active":true' && exit 0
echo '{"hookSpecificOutput":{"hookEventName":"Stop","additionalContext":"Antes de terminar: si en este uso de la skill <nombre-de-la-skill> el usuario corrigió algo, algo falló o mostró una preferencia, propón de 0 a 3 aprendizajes para su LEARNINGS.md (fecha, una línea y el porqué), enséñalos y pide OK antes de escribirlos. Si ya propusiste aprendizajes en este turno, no los repitas. Si no hay nada que aprender, termina sin añadir nada."}}'