Todoist
Gestiona proyectos, secciones, tareas y etiquetas de Todoist usando lenguaje natural con asistentes de IA.
Documentación
Servidor MCP de Todoist
Un servidor de Model Context Protocol (MCP) que conecta la API de Todoist con asistentes de IA como Claude. Este servidor permite que los asistentes de IA interactúen con tus proyectos, secciones, tareas y etiquetas de Todoist, permitiéndote gestionar todo tu flujo de trabajo de productividad mediante conversaciones en lenguaje natural.
El servidor MCP de Todoist proporciona un puente entre los asistentes de IA y tu espacio de trabajo de Todoist, habilitando una gestión fluida de proyectos, secciones, tareas y etiquetas a través de interfaces conversacionales.
Tabla de Contenidos
Requisitos Previos
Antes de usar este servidor MCP, necesitarás un token de API de Todoist:
- Ve a Configuración de Desarrollador de Todoist
- Copia tu token de API
Uso
Para usar este servidor con un cliente MCP, añade la siguiente configuración:
{
"mcpServers": {
"todoist": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"TODOIST_API_TOKEN=<your_api_token_here>",
"ghcr.io/koki-develop/todoist-mcp-server:latest"
]
}
}
}
Reemplaza <your_api_token_here> con tu token de API de Todoist real.
Herramientas MCP
El servidor proporciona las siguientes herramientas que los asistentes de IA pueden usar para interactuar con tus datos de Todoist:
Proyectos
get_projects
Recupera todos los proyectos de Todoist accesibles para el usuario autenticado. Devuelve información completa del proyecto, incluyendo proyectos personales y de espacio de trabajo con metadatos como nombre, color, estado de favorito, estilo de vista e información de jerarquía.
get_project
Accede a información detallada de un proyecto específico de Todoist usando su identificador único. Proporciona metadatos completos del proyecto, incluyendo configuración, jerarquía y detalles organizativos.
create_project
Crea un nuevo proyecto de Todoist con configuraciones personalizables.
update_project
Modifica las propiedades de un proyecto de Todoist existente.
delete_project
Elimina permanentemente un proyecto de Todoist por su identificador único. Esta acción elimina el proyecto y todas las tareas, secciones y comentarios asociados. Esta operación no se puede deshacer.
Secciones
get_sections
Recupera todas las secciones dentro de un proyecto específico de Todoist. Devuelve una lista completa de secciones con sus metadatos como nombre, orden, marcas de tiempo de creación y actualización, e información de estado. Las secciones se devuelven en su orden de visualización dentro del proyecto.
get_section
Accede a información detallada de una sección específica de Todoist usando su identificador único. Proporciona metadatos completos de la sección, incluyendo nombre, asignación de proyecto, posición de orden, marcas de tiempo y banderas de estado.
create_section
Crea una nueva sección dentro de un proyecto de Todoist para organizar tareas. Las secciones ayudan a categorizar y agrupar tareas relacionadas dentro de un proyecto.
update_section
Modifica el nombre de una sección existente de Todoist. Actualmente, solo se puede actualizar el nombre de la sección.
delete_section
Elimina permanentemente una sección de Todoist por su identificador único. Esta acción elimina la sección y mueve cualquier tarea en esta sección al área principal del proyecto. Esta operación no se puede deshacer.
Tareas
get_tasks
Recupera tareas de Todoist con opciones de filtrado flexibles. Devuelve una lista completa de tareas con sus metadatos, incluyendo contenido, descripción, asignación de proyecto, fechas de vencimiento, niveles de prioridad, etiquetas, estado de finalización e información de jerarquía. Sin filtros, devuelve todas las tareas accesibles para el usuario autenticado.
get_tasks_by_filter
Recupera tareas de Todoist usando sintaxis de filtro avanzada. Admite consultas de filtro potentes usando la sintaxis de filtro en lenguaje natural de Todoist para búsquedas complejas de tareas. Maneja automáticamente la paginación para recuperar todas las tareas coincidentes.
get_task
Accede a información detallada de una tarea específica de Todoist usando su identificador único. Proporciona metadatos completos de la tarea, incluyendo contenido, descripción, asignación de proyecto y sección, información de fecha de vencimiento, nivel de prioridad, etiquetas asignadas, estado de finalización, relaciones padre-hijo y marcas de tiempo.
create_task
Crea una nueva tarea de Todoist con opciones de configuración completas.
update_task
Modifica las propiedades de una tarea existente de Todoist.
delete_task
Elimina permanentemente una tarea de Todoist por su identificador único. Esta acción elimina la tarea y todos los comentarios y archivos adjuntos asociados. Si la tarea tiene subtareas, también se eliminarán. Esta operación no se puede deshacer.
close_task
Marca una tarea de Todoist como completada. Esta acción mueve la tarea al estado completado mientras conserva todos los datos e historial de la tarea. Las tareas completadas se pueden reabrir más tarde si es necesario.
reopen_task
Reabre una tarea de Todoist previamente completada, devolviéndola al estado activo. Esta acción restaura la tarea a su estado anterior antes de la finalización.
move_tasks_to_project
Mueve múltiples tareas a un proyecto diferente dentro de Todoist. Esta herramienta permite una reorganización eficiente de tareas en masa al cambiar la asignación de proyecto para múltiples tareas simultáneamente. Todas las tareas especificadas se moverán de sus ubicaciones actuales al proyecto de destino.
move_tasks_to_section
Mueve múltiples tareas a una sección diferente dentro de Todoist. Esta herramienta permite la organización de tareas en masa al cambiar la asignación de sección para múltiples tareas a la vez. Todas las tareas especificadas se moverán de sus ubicaciones actuales a la sección de destino.
move_tasks_to_parent
Mueve múltiples tareas para convertirlas en subtareas de otra tarea dentro de Todoist. Esta herramienta permite la creación de jerarquías de tareas al hacer que múltiples tareas sean hijas de una tarea padre especificada. Todas las tareas especificadas se convertirán en subtareas del padre de destino.
Etiquetas
create_label
Crea una nueva etiqueta personal con propiedades personalizables, incluyendo nombre, color, orden de visualización y estado de favorito. Las etiquetas se pueden usar para categorizar y organizar tareas entre proyectos.
update_label
Modifica las propiedades de una etiqueta personal existente. Permite cambiar el nombre, color, orden de visualización y estado de favorito de la etiqueta. Todos los parámetros excepto el ID de la etiqueta son opcionales, por lo que puedes actualizar solo las propiedades específicas que deseas cambiar.
get_label
Recupera una etiqueta personal específica por su ID único con metadatos completos, incluyendo nombre, color, orden y estado de favorito. Devuelve información detallada sobre la etiqueta solicitada para su uso en la organización y filtrado de tareas. Requiere un ID de etiqueta válido que pertenezca al usuario autenticado.
get_labels
Recupera todas las etiquetas personales accesibles para el usuario autenticado con sus metadatos completos, incluyendo nombre, color, orden y estado de favorito. Devuelve una lista completa de etiquetas que se pueden usar para la organización y filtrado de tareas. Esta herramienta proporciona acceso de solo lectura a la información de etiquetas y maneja la paginación automáticamente.
delete_label
Elimina permanentemente una etiqueta personal por su identificador único. ADVERTENCIA: Esta acción es IRREVERSIBLE y eliminará automáticamente la etiqueta de todas las tareas asociadas. Úsala con precaución, ya que las etiquetas eliminadas no se pueden recuperar.
Comentarios
create_task_comment
Añade un comentario a una tarea específica de Todoist. Admite contenido de texto enriquecido y archivos adjuntos opcionales. Devuelve el objeto de comentario completo con todos los metadatos tras la creación exitosa.
create_project_comment
Añade un comentario a un proyecto específico de Todoist. Admite contenido de texto enriquecido y archivos adjuntos opcionales. Devuelve el objeto de comentario completo con todos los metadatos tras la creación exitosa.
update_comment
Actualiza el contenido de un comentario existente en Todoist. Esto te permite modificar el contenido de texto de los comentarios en tareas o proyectos. Los metadatos del comentario, como la hora de publicación, el autor y los archivos adjuntos, se conservan. Devuelve el objeto de comentario actualizado con el contenido actual.
get_task_comments
Recupera todos los comentarios asociados con una tarea específica de Todoist. Devuelve una lista completa de comentarios con sus metadatos, incluyendo contenido, información del autor, marcas de tiempo, archivos adjuntos y reacciones. Los comentarios se devuelven en orden cronológico. Maneja automáticamente la paginación para recuperar todos los comentarios de la tarea.
get_project_comments
Recupera todos los comentarios asociados con un proyecto específico de Todoist. Devuelve una lista completa de comentarios a nivel de proyecto con sus metadatos, incluyendo contenido, información del autor, marcas de tiempo, archivos adjuntos y reacciones. Los comentarios se devuelven en orden cronológico. Maneja automáticamente la paginación para recuperar todos los comentarios del proyecto.
delete_comment
Elimina permanentemente un comentario por su identificador único. Esta acción eliminará el comentario de su tarea o proyecto asociado. Esta operación no se puede deshacer, así que úsala con precaución. Devuelve confirmación de eliminación exitosa o notificación de fallo.
Licencia
Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo LICENCIA para más detalles.
Copyright (c) 2025 Koki Sato