Todoist

Servidor MCP de Todoist

Un servidor de Model Context Protocol (MCP) que permite a clientes como Claude interactuar con Todoist, habilitando capacidades de gestión de tareas a través de lenguaje natural. El servidor actúa como intermediario entre los clientes y la API de Todoist, manejando autenticación, transformación de datos y procesamiento de comandos. Esta es una versión en Python.

Características

• Creación de tareas: Crea nuevas tareas con contenido requerido y atributos opcionales
• Recuperación de tareas: Obtén tareas por ID o lista tareas con opciones de filtrado
• Gestión de tareas: Actualiza atributos de tareas, marca tareas como completadas, elimina tareas

Requisitos previos

• Python 3.12
• uv
• Una cuenta de Todoist y token de API

Cómo obtener el token de API de Todoist

1. Inicia sesión en tu cuenta de Todoist
2. Ve a Configuración de usuario -> Integraciones -> Desarrollador
3. Copia el token de API

Uso con Claude Desktop

Ejecutar mediante UVX (sin clonar)

Puedes ejecutar el servidor directamente desde GitHub usando UVX:

uvx --from https://github.com/Johnxjp/todoist-mcp-python.git mcp-server-todoist

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

{
  "mcpServers": {
    "todoist-server": {
      "command": "uvx",
      "args": [
        "--from", 
        "https://github.com/Johnxjp/todoist-mcp-python.git", 
        "mcp-server-todoist"
      ],
      "env": {
        "TODOIST_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

Ejecutar desde un repositorio clonado

Si prefieres clonar el repositorio, usa estos comandos:

git clone git@github.com:Johnxjp/todoist-mcp-python.git

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

{
  "mcpServers": {
    "todoist-server": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "todoist_api_python",
        "mcp",
        "run",
        "/full/path/to/todoist_server.py"
      ],
      "env": {
        "TODOIST_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

Herramientas disponibles

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

1. create_task: Crea una nueva tarea en Todoist
   • Requerido: content (título de la tarea)
     • Opcional:
     • description, - due_date, - priority, - project_id, - section_id, - labels
2. get_tasks: Obtén una lista de tareas e IDs de Todoist con varios filtros
   • Opcional:
     • project_id, - project_name, - task_name, - priority, - labels, - is_overdue, - limit
3. update_task: Actualiza una tarea existente buscándola por nombre
   • Requerido: task_id
     • Opcional:
     • content, - description, - labels, - priority, - due_date (AAAA-MM-DD), - deadline_date (AAAA-MM-DD)
4. delete_task: Elimina una tarea buscándola por nombre
   • Requerido: task_id
5. complete_task: Marca una tarea como completada buscándola por nombre
   • Requerido: task_id

Ejemplos de interacción

Aquí hay algunos ejemplos de cómo Claude puede interactuar con Todoist a través de este servidor MCP:

• "Agrega una tarea para comprar víveres"
• "Muéstrame todas mis tareas urgentes"
• "¿Qué tareas vencen hoy?"
• "Marca la tarea de lavandería como hecha"
• "Cambia la prioridad de mi cita con el dentista a urgente"

Consideraciones de seguridad

• El servidor maneja de forma segura tu token de API de Todoist a través de variables de entorno
• Nunca compartas tu archivo .env ni expongas tu token de API
• El servidor se ejecuta localmente y se comunica únicamente con la API de Todoist