Servidor MCP de Todoist

Un servidor de Protocolo de Contexto de Modelo (MCP) para Todoist, que permite la gestión avanzada de tareas y proyectos a través de Claude Desktop y otros clientes compatibles con MCP.

Requisitos

Node.js (se recomienda v18 o superior)
npm o hilo
Una cuenta de Todoist
Un token de API de Todoist (consulte https://todoist.com/prefs/integrations )

Características

Enumerar, crear, actualizar, completar, reabrir y eliminar tareas
Enumerar, crear, actualizar, archivar, desarchivar y eliminar proyectos
Enumerar, crear, actualizar y eliminar secciones
Enumerar, crear, actualizar y eliminar etiquetas
Enumerar, crear, actualizar y eliminar comentarios
Administrar etiquetas compartidas
Obtener colaboradores del proyecto

Todas las funciones

Tareas : enumerar, obtener, crear, actualizar, completar, reabrir, eliminar
Proyectos : Listar, obtener, crear, actualizar, archivar, desarchivar, eliminar
Secciones : Lista (por proyecto), obtener, crear, actualizar, eliminar
Etiquetas : Listar, obtener, crear, actualizar, eliminar, administrar etiquetas compartidas
Comentarios : Lista (por tarea/proyecto), obtener, crear, actualizar, eliminar
Colaboradores : Lista de colaboradores del proyecto

Instalación

Para Claude Desktop (JSON)

Si se publica como un paquete npm, puedes usarlo directamente con npx en tu configuración de Claude Desktop:

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": [
        "todoist-mcp"
      ],
      "env": {
        "TODOIST_API_TOKEN": "your_todoist_token"
      }
    }
  }
}

Establezca TODOIST_API_TOKEN como se muestra.

Instalación manual

Clonar el repositorio:
git clone https://github.com/yourusername/todoist-mcp.git cd todoist-mcp
Instalar dependencias:
npm install # or yarn install
Construir el proyecto:
npm run build # or yarn build
Establezca su token de API de Todoist como una variable de entorno (ver arriba).
Ejecute el servidor compilado:
node dist/server.js
Configure Claude Desktop para usar su compilación local agregando esto a su archivo de configuración:
{ "mcpServers": { "todoist": { "command": "node", "args": [ "/path/to/todoist-mcp/dist/server.js" ], "env": { "TODOIST_API_TOKEN": "your_todoist_token" } } } }

Ejemplos de uso

Obtener tareas de máxima prioridad:
"Muéstrame mis tareas más prioritarias"
Crear y clasificar etiquetas:
"Crea etiquetas para mis tareas y clasifícalas por proyecto o urgencia."
Organizar tareas por sección:
"Mueva todas las tareas con la etiqueta 'urgente' a la sección 'Hoy'."
Gestión de proyectos:
"Crea un nuevo proyecto llamado 'Crecimiento personal' y agrega una sección 'Lista de lectura'."
Descripción general del colaborador:
"Enumere todos los colaboradores del proyecto 'Lanzamiento del equipo'."
Gestión de comentarios:
Añade un comentario a la tarea "Preparar diapositivas" con el contenido "Recuerda incluir los resultados del segundo trimestre".

Licencia

Este proyecto está licenciado bajo la licencia MIT. Consulte la LICENCIA para más detalles.

Todoist MCP Server