Servidor MCP de Todoist

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a clientes como Claude interactuar con Todoist, lo que permite la gestión de tareas mediante lenguaje natural. El servidor actúa como intermediario entre los clientes y la API de Todoist, gestionando la autenticación, la transformación de datos y el procesamiento de comandos. Esta es una versión de Python.

Características

Creación de tareas : crea nuevas tareas con el contenido requerido y atributos opcionales
Recuperación de tareas : obtenga tareas por ID o enumere tareas con opciones de filtrado
Gestión de tareas : actualizar atributos de tareas, marcar tareas como completadas, eliminar tareas

Prerrequisitos

Python 3.12
ultravioleta
Una cuenta Todoist y un token API

Cómo obtener el token API de Todoist

Inicia sesión en tu cuenta de Todoist
Vaya a Configuración de usuario -> Integraciones -> Desarrollador
Copiar token de API

Uso con Claude Desktop

Ejecutar a través de UVX (sin clonación)

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 el repositorio clonado

Si prefiere clonar el repositorio, utilice 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 utilice:

create_task : Crea una nueva tarea en Todoist
- Requerido: contenido (título de la tarea)
- Opcional:
  - descripción,
  - fecha de vencimiento,
  - prioridad,
  - id_del_proyecto,
  - id_de_sección,
  - etiquetas
get_tasks : Obtenga una lista de tareas e ID de Todoist con varios filtros
- Opcional:
  - id_del_proyecto,
  - nombre_del_proyecto,
  - nombre_de_tarea,
  - prioridad,
  - etiquetas,
  - está_vencido,
  - límite
update_task : Actualizar una tarea existente buscándola por nombre
- Obligatorio: task_id
- Opcional:
  - contenido,
  - descripción,
  - etiquetas,
  - prioridad,
  - fecha_de_vencimiento (AAAA-MM-DD),
  - fecha_límite (AAAA-MM-DD)
delete_task : Eliminar una tarea buscándola por nombre
- Obligatorio: task_id
complete_task : Marcar una tarea como completa buscándola por nombre
- Obligatorio: task_id

Ejemplos de interacciones

A continuación se muestran algunos ejemplos de cómo Claude puede interactuar con Todoist a través de este servidor MCP:

"Añadir una tarea para comprar comestibles"
"Muéstrame todas mis tareas urgentes"
"¿Qué tareas hay que realizar hoy?"
Marcar la tarea de lavandería como realizada
Cambiar la prioridad de mi cita con el dentista a urgente

Consideraciones de seguridad

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

Licencia

Licencia MIT

Todoist Python MCP Server

Integrations