TaskMaster Todoist

🚀 TaskMaster: Todoist MCP para Cursor AI

Una implementación de servidor de Model Context Protocol (MCP) para la integración con Todoist, desarrollada específicamente para Cursor AI. Este servidor permite que los asistentes de Cursor AI interactúen con tus tareas de Todoist directamente desde tu entorno de codificación.

Video de demostración

Características

• Filtrado flexible de tareas: Filtra tareas usando la potente sintaxis de filtros de Todoist
  • Filtra por fecha de vencimiento: hoy, mañana, vencidas
  • Filtra por niveles de prioridad (1-4, donde 1 es la más alta)
  • Filtra usando combinaciones complejas de consultas
• Formato enriquecido de tareas: Cada tarea muestra prioridad, fecha de vencimiento y otra información relevante con iconos claros
• Integración con Cursor AI: Usa Todoist sin problemas dentro de tu entorno de codificación de Cursor AI

Instalación

Instalación mediante Smithery

Para instalar TaskMaster para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install @mingolladaniele/taskMaster-todoist-mcp --client claude

Requisitos previos

• Python 3.10 o superior
• Poetry (para la gestión de dependencias)
• Cuenta de Todoist y token de API

Configuración

1. Clona este repositorio:

git clone https://github.com/mingolladaniele/todoist-mcp.git
cd todoist-mcp

2. Instala las dependencias:

pip install -r requirements.txt

3. Establece tu token de API de Todoist como variable de entorno:

# Linux/macOS
export TODOIST_API_TOKEN="your-api-token-here"

# Windows
set TODOIST_API_TOKEN="your-api-token-here"

Puedes encontrar tu token de API de Todoist en Configuración de Todoist → Integraciones → Desarrollador.

Uso

Ejecutando el servidor

python server.py

Herramienta MCP

El servidor proporciona la siguiente herramienta MCP:

get_tasks_tool

Recupera tareas con potentes opciones de filtrado.

Parámetros:

• filter_string: Cadena de consulta de filtro avanzada de Todoist para filtrado complejo
• priority: Nivel de prioridad opcional (1-4, donde 1 es la prioridad más alta)

Ejemplos de cadenas de filtro:

• "today" - Tareas que vencen hoy
• "overdue" - Tareas vencidas
• "Jan 3" - Tareas que vencen el 3 de enero
• "due before: May 5" - Tareas que vencen antes del 5 de mayo
• "due after: May 5" - Tareas que vencen después del 5 de mayo
• "due before: +4 hours" - Tareas que vencen dentro de las próximas cuatro horas y todas las tareas vencidas
• "no date" - Tareas sin fecha de vencimiento
• "5 days" o "next 5 days" - Tareas que vencen en los próximos 5 días
• "recurring" - Tareas con fecha recurrente

Configuración con Cursor AI

Para usar con Cursor AI, crea o edita el archivo de configuración de MCP:

Windows: C:\Users\<username>\.cursor\mcp.json

{
  "mcpServers": {
    "todoist-mcp": {
      "command": "C:/Users/<username>/path/to/todoist-mcp/.venv/Scripts/python.exe",
      "args": [
        "C:/Users/<username>/path/to/todoist-mcp/server.py"
      ],
      "env": {
        "TODOIST_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Reemplaza <username> y las rutas con tu nombre de usuario real y las rutas correctas a tu instalación.

Una vez hecho esto, ve a Configuración de Cursor → MCP y verifica que el servidor se esté ejecutando correctamente (punto verde).

Estructura del Proyecto

El código base está organizado en módulos:

• api/: Envoltorio de API para Todoist
• config/: Configuración y ajustes
• utils/: Funciones de utilidad y ayudantes, incluido el formato de tareas

Hoja de ruta

Estas son las características planificadas para futuras versiones:

• Creación de tareas: Añade nuevas tareas a tu Todoist directamente desde Cursor AI
• Completar tareas: Marca tareas como completadas sin cambiar de contexto
• Eliminación de tareas: Elimina tareas que ya no sean necesarias
• Equilibrio inteligente de tareas: Reequilibrio de tareas impulsado por IA basado en:
  • Prioridad del proyecto
  • Compromisos de tiempo
  • Fechas de vencimiento
  • Carga de trabajo actual
• Gestión de proyectos: Crea y gestiona proyectos de Todoist
• Etiquetas y filtros: Añade etiquetas personalizadas y crea filtros guardados

Licencia

Licencia MIT