Servidor MCP de Todoist

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a clientes como Claude interactuar con Todoist, lo que permite la gestión de tareas mediante lenguaje natural. El servidor actúa como intermediario entre los clientes y la API de Todoist, gestionando la autenticación, la transformación de datos y el procesamiento de comandos. Esta es una versión de Python.

Características

• Creación de tareas : crea nuevas tareas con el contenido requerido y atributos opcionales

• Recuperación de tareas : obtenga tareas por ID o enumere tareas con opciones de filtrado

• Gestión de tareas : actualizar atributos de tareas, marcar tareas como completadas, eliminar tareas

Prerrequisitos

• Python 3.12

• ultravioleta

• Una cuenta Todoist y un token API

Cómo obtener el token API de Todoist

1. Inicia sesión en tu cuenta de Todoist

2. Vaya a Configuración de usuario -> Integraciones -> Desarrollador

3. Copiar token de API

Uso con Claude Desktop

Ejecutar a través de UVX (sin clonación)

Puedes ejecutar el servidor directamente desde GitHub usando UVX:

Luego agrega esta configuración a tu configuración de Claude:

Ejecutar desde el repositorio clonado

Si prefiere clonar el repositorio, utilice estos comandos:

Luego agrega a tu archivo de configuración de Claude:

Herramientas disponibles

El servidor proporciona las siguientes herramientas para que Claude las utilice:

1. create_task : Crea una nueva tarea en Todoist

   • Requerido: contenido (título de la tarea)

   • Opcional:

     • descripción,

     • fecha de vencimiento,

     • prioridad,

     • id_del_proyecto,

     • id_de_sección,

     • etiquetas

2. get_tasks : Obtenga una lista de tareas e ID de Todoist con varios filtros

   • Opcional:

     • id_del_proyecto,

     • nombre_del_proyecto,

     • nombre_de_tarea,

     • prioridad,

     • etiquetas,

     • está_vencido,

     • límite

3. update_task : Actualizar una tarea existente buscándola por nombre

   • Obligatorio: task_id

   • Opcional:

     • contenido,

     • descripción,

     • etiquetas,

     • prioridad,

     • fecha_de_vencimiento (AAAA-MM-DD),

     • fecha_límite (AAAA-MM-DD)

4. delete_task : Eliminar una tarea buscándola por nombre

   • Obligatorio: task_id

5. complete_task : Marcar una tarea como completa buscándola por nombre

   • Obligatorio: task_id

Ejemplos de interacciones

A continuación se muestran algunos ejemplos de cómo Claude puede interactuar con Todoist a través de este servidor MCP:

• "Añadir una tarea para comprar comestibles"

• "Muéstrame todas mis tareas urgentes"

• "¿Qué tareas hay que realizar hoy?"

• Marcar la tarea de lavandería como realizada

• Cambiar la prioridad de mi cita con el dentista a urgente

Consideraciones de seguridad

• El servidor maneja de forma segura su token de API de Todoist a través de variables de entorno

• Nunca comparta su archivo .env ni exponga su token API

• El servidor se ejecuta localmente y se comunica únicamente con la API de Todoist

Licencia

Licencia MIT

Expresiones de gratitud

• Cliente Python de la API de Todoist

• Protocolo de contexto modelo