Servidor MCP extendido de Todoist

Una implementación de servidor MCP (Protocolo de Contexto de Modelo) que integra Claude (o cualquier LLM compatible con MCP si eres un experto en ello) con Todoist, lo que permite la gestión de tareas en lenguaje natural mediante herramientas MCP. Las herramientas de este servidor permiten a Claude interactuar con tus tareas, proyectos, secciones y etiquetas de Todoist con un lenguaje cotidiano, a la vez que están optimizadas para la eficiencia del flujo de trabajo LLM.

Descripción general de las características

• Gestión de tareas : cree, actualice, complete y elimine tareas utilizando un lenguaje cotidiano
• Gestión de etiquetas : cree, actualice y administre etiquetas personales y etiquetas de tareas
• Gestión de proyectos : crea, actualiza y gestiona proyectos de Todoist
• Organización de secciones : crear y administrar secciones dentro de los proyectos
• Búsqueda inteligente : encuentre tareas y etiquetas usando coincidencias de nombres parciales
• Filtrado flexible : filtre tareas por proyecto, sección, fecha de vencimiento, prioridad y etiquetas
• Detalles de tareas enriquecidos : soporte para descripciones, fechas de vencimiento, niveles de prioridad y asignación de proyectos/secciones
• Operaciones por lotes : las herramientas tienen soporte integrado para operaciones por lotes y parámetros personalizados para un uso eficiente con flujos de trabajo LLM

Para obtener una lista completa de las herramientas disponibles y su uso, consulte tools.md .

Guía de instalación rápida

Suponiendo que ya tienes npm instalado.

Puede encontrar una guía de instalación más completa en la Guía práctica.

Instalación mediante herrería

Para instalar Todoist MCP Server Extended para Claude Desktop a través de Smithery :

1. Ejecute el siguiente comando en cmd\pwsh:

También es compatible con cline o windsurf, cambiando el último parámetro a --client cline o --client windsurf

Instalación mediante npm

1. Ejecute el siguiente comando en cmd\pwsh:

Configuración

Obtén un token de API de Todoist

1. Inicia sesión en tu cuenta de Todoist
2. Vaya a Settings → Integrations
3. Encuentra tu token de API en Developer
4. Presione Copy API Token

Para obtener más información sobre la API de Todoist, visita la documentación oficial de la API de Todoist .

Agregar servidor MCP y token API al cliente de escritorio Claude

1. En su archivo claude_desktop_config.json , pegue el siguiente fragmento de json entre: "mcpServers":{ }:
   "todoist": { "command": "npx", "args": ["-y", "@chrusic/todoist-mcp-server-extended"], "env": { "TODOIST_API_TOKEN": "PASTE-YOUR-API-TOKEN-HERE" } }
2. Una vez montado todo debería verse así:
   { "mcpServers": { "todoist": { "command": "npx", "args": ["-y", "@chrusic/todoist-mcp-server-extended"], "env": { "TODOIST_API_TOKEN": "PASTE-YOUR-API-TOKEN-HERE" } } } }
3. Luego, el cliente de escritorio Claude iniciará el servidor MCP y cargará las herramientas en el próximo (re)inicio del cliente.

Ejemplo de uso

Algunas sugerencias sencillas sobre qué preguntarle a Claude. Ten en cuenta que a veces hay que ser muy directo para que Claude use las herramientas:

• "Usando la herramienta MCP: todoist_get_tasks, enumera todas mis tareas del día".
• Crear la tarea "Revisar PR" en la sección "Por hacer" del proyecto "Trabajo".
• Agregar la etiqueta 'Importante' a la tarea 'Revisar PR'
• Mostrar todas las tareas etiquetadas como "Importante" en el proyecto "Trabajo".
• Mover la tarea "Documentación" a la sección "En curso".
• Marcar la tarea de documentación como completada
• "Dame algunas sugerencias de tareas enumeradas que puedo hacer hoy, ya que voy de compras a la ciudad".
• "Divida la tarea X en subtareas más pequeñas y agregue fechas de vencimiento, x, y, z".

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Problemas y soporte

Si encuentra algún problema o necesita ayuda, informe un problema en el repositorio de GitHub .