TaskMaster: Todoist MCP para Cursor AI

Implementación de un servidor de Protocolo de Contexto de Modelo (MCP) para la integración de Todoist, desarrollado 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 programación.

Vídeo de demostración

Related MCP server: MCP Todoist

Características

• Filtrado flexible de tareas : filtra tareas utilizando la potente sintaxis de filtro de Todoist

  • Filtrar por fecha de vencimiento: hoy, mañana, vencido

  • Filtrar por niveles de prioridad (1-4, donde 1 es el más alto)

  • Filtrar mediante combinaciones de consultas complejas

• Formato de tareas enriquecido : cada tarea muestra la prioridad, la fecha de vencimiento y otra información relevante con íconos claros

• Integración de Cursor AI : use Todoist sin problemas dentro de su entorno de codificación de Cursor AI

Instalación

Prerrequisitos

• Python 3.10 o superior

• Poesía (para la gestión de la dependencia)

• Cuenta Todoist y token API

Configuración

1. Clonar este repositorio:

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

2. Instalar dependencias:

pip install -r requirements.txt

3. Establezca su token de API de Todoist como una 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 avanzado de Todoist para filtrado complejo

• priority : nivel de prioridad opcional (1-4, donde 1 es la máxima prioridad)

Ejemplo de cadenas de filtro:

• "today" - Tareas que vencen hoy

• "overdue" - Tareas vencidas

• "Jan 3" : Tareas con fecha de entrega el 3 de enero

• "due before: May 5" - Tareas con fecha de entrega antes del 5 de mayo

• "due after: May 5" - Tareas con fecha de entrega posterior al 5 de mayo

• "due before: +4 hours" : tareas con vencimiento en las próximas cuatro horas y todas las tareas vencidas

• "no date" - Tareas sin fecha de vencimiento

• "5 days" o "next 5 days" : Tareas con vencimiento en los próximos 5 días

• "recurring" : tareas con una fecha recurrente

Configuración con Cursor AI

Para utilizar con Cursor AI, cree o edite 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"
      }
    }
  }
}

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

Una vez que hagas eso, ve a Configuración del cursor → MCP y verifica que el servidor esté funcionando correctamente (punto verde).

Estructura del proyecto

La base del código está organizada en módulos:

• api/ : contenedor 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 : agrega nuevas tareas a tu Todoist directamente desde Cursor AI

• Finalización de tareas : marcar tareas como completadas sin cambiar de contexto

• Eliminación de tareas : elimine 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 : agregue etiquetas personalizadas y cree filtros guardados

Licencia

Licencia MIT