remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Allows Cursor AI assistants to interact with Todoist tasks, providing tools for task retrieval with powerful filtering options by due date, priority, and complex queries.

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

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

Clonar este repositorio:

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

Instalar dependencias:

pip install -r requirements.txt

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

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Un servidor de protocolo de contexto de modelo que permite a los asistentes de Cursor AI interactuar con las tareas de Todoist directamente desde el entorno de codificación, admitiendo filtrado de tareas avanzado y formato enriquecido.