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:

• Establezca TODOIST_API_TOKEN como se muestra.

Instalación manual

1. Clonar el repositorio:

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

2. Instalar dependencias:

   npm install # or yarn install

3. Construir el proyecto:

   npm run build # or yarn build

4. Establezca su token de API de Todoist como una variable de entorno (ver arriba).

5. Ejecute el servidor compilado:

   node dist/server.js

6. 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.