Todoist

Un servidor no oficial para gestionar tareas de Todoist, que permite a los agentes crearlas, listarlas y completarlas.

GitHub

Documentación

Servidor MCP de Todoist

Servidor MCP no oficial para Todoist que permite a los agentes crear y listar tareas en tu cuenta de Todoist.

Características

  • Crear tareas con descripciones, fechas de vencimiento, prioridades, etiquetas y proyectos.
  • Listar tareas Lista tareas completadas o no completadas con filtrado por proyecto o filtros de Todoist.

Funciona con Claude Desktop, Cursor y otros clientes MCP

Instalación

pip install todoist-mcp-server

Configuración

1. Obtén tu Token de API de Todoist

  1. Ve a Configuración de integraciones de Todoist
  2. Desplázate hasta "API token"
  3. Copia tu token de API (¡mantenlo seguro!)

2. Configura tu Cliente MCP

Ejemplos de Uso

Aquí hay algunos ejemplos de cómo usar el servidor MCP de Todoist con diferentes clientes:

Claude Desktop

Añade esto a tu archivo claude_desktop_config.json: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%/Claude/claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "todoist": {
      "command": "todoist-mcp-server",
      "env": {
        "TODOIST_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Cursor

Añade esto a la configuración de Cursor:

  1. Abre la Configuración de Cursor (Cmd/Ctrl + ,)
  2. Busca "MCP"
  3. Añade la configuración del servidor MCP:
{
  "mcpServers": {
    "todoist": {
      "command": "todoist-mcp-server",
      "env": {
        "TODOIST_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Otros Clientes MCP

Para cualquier cliente compatible con MCP, usa:

  • Comando: todoist-mcp-server
  • Variable de entorno: TODOIST_API_TOKEN=your-token

3. Reinicia tu Cliente

Reinicia Claude Desktop, Cursor o tu cliente MCP para cargar el servidor.

Uso

Una vez configurado, puedes interactuar con Todoist usando lenguaje natural:

Crear Tareas

  • "Crea una tarea para comprar víveres"
  • "Añade una tarea 'Llamar al dentista' con vencimiento mañana y prioridad alta"
  • "Crea una tarea para terminar el informe con descripción 'Incluir métricas del Q4' con vencimiento el próximo viernes"

Listar Tareas

  • "Muéstrame mis tareas para hoy"
  • "Lista todas mis tareas de prioridad alta"
  • "¿Qué tareas tengo en mi proyecto de Trabajo?"

Herramientas Disponibles

create_task

Crea una nueva tarea en Todoist.

Parámetros:

  • content (obligatorio): Título/contenido de la tarea
  • description (opcional): Descripción de la tarea
  • project_name (opcional): Nombre del proyecto al que añadir la tarea
  • due_string (opcional): Fecha de vencimiento en lenguaje natural ("mañana", "próximo lunes")
  • priority (opcional): Nivel de prioridad 1-4 (1=baja, 2=media, 3=alta, 4=urgente)
  • labels (opcional): Lista de nombres de etiquetas

list_active_tasks

Lista tareas activas de Todoist.

Parámetros:

  • project_name (opcional): Filtrar por nombre de proyecto
  • filter_string (opcional): Filtro de Todoist ("hoy", "vencidas", "p1")
  • limit (opcional): Número máximo de tareas (predeterminado: 50)

Solución de Problemas

Error de "Servidor desconectado"

  1. Asegúrate de haber instalado el paquete: pip install todoist-mcp-server
  2. Verifica que tu token de API sea correcto
  3. Comprueba que el archivo de configuración esté en la ubicación correcta
  4. Reinicia tu cliente MCP por completo

Error de "Comando no encontrado" o "ENOENT"

La causa más común es que tu cliente MCP no puede encontrar el comando todoist-mcp-server en su PATH.

Solución: Usa la ruta completa al comando

  1. Encuentra dónde está instalado el comando:

    which todoist-mcp-server

  2. Usa la ruta completa en tu configuración MCP:

    {
  "mcpServers": {
    "todoist": {
      "command": "/full/path/to/todoist-mcp-server",
      "env": {
        "TODOIST_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Otras soluciones:

  • Asegúrate de que el paquete esté instalado en el mismo entorno de Python que usa tu cliente MCP
  • Intenta reinstalar: pip uninstall todoist-mcp-server && pip install todoist-mcp-server

Problemas con el Token de API

  • Obtén un token nuevo desde Integraciones de Todoist
  • Asegúrate de que no haya espacios adicionales en tu archivo de configuración
  • Verifica que el token tenga los permisos necesarios

Desarrollo

Para contribuir o ejecutar desde el código fuente:

git clone https://github.com/mehularora8/todoist-mcp
cd todoist-mcp
pip install -e .

Seguridad

  • Tu token de API se almacena localmente y solo se usa para comunicarse con la API de Todoist
  • No se envían datos a terceros
  • El servidor MCP se ejecuta localmente en tu máquina

Licencia

Licencia MIT: consulta el archivo LICENSE para más detalles.

Soporte

Nota: Esta es una integración no oficial y no está afiliada con Todoist o Doist Inc.