Todoist MCP

Servidor Todoist MCP

Una implementación de servidor MCP (Model Context Protocol) que integra Claude con Todoist, permitiendo la gestión de tareas en lenguaje natural. Este servidor permite que Claude interactúe con tus tareas de Todoist usando lenguaje cotidiano.

Características

• Gestión de tareas en lenguaje natural: Crea, actualiza, completa y elimina tareas usando lenguaje cotidiano
• Búsqueda inteligente de tareas: Encuentra tareas usando coincidencias parciales de nombre
• Filtrado flexible: Filtra tareas por fecha de vencimiento, prioridad y otros atributos
• Detalles enriquecidos de tareas: Soporte para descripciones, fechas de vencimiento y niveles de prioridad
• Manejo intuitivo de errores: Retroalimentación clara para una mejor experiencia de usuario

Instalación

Instalación mediante Smithery

Para instalar el Servidor Todoist MCP para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install @abhiz123/todoist-mcp-server --client claude

Instalación manual

npm install -g @abhiz123/todoist-mcp-server

Herramientas

todoist_create_task

Crea nuevas tareas con varios atributos:

• Requerido: contenido (título de la tarea)
• Opcional: descripción, fecha de vencimiento, nivel de prioridad (1-4)
• Ejemplo: "Crea la tarea 'Reunión de equipo' con la descripción 'Sincronización semanal' para mañana"

todoist_get_tasks

Recupera y filtra tareas:

• Filtra por fecha de vencimiento, prioridad o proyecto
• Filtrado de fechas en lenguaje natural
• Límite de resultados opcional
• Ejemplo: "Muestra las tareas de alta prioridad que vencen esta semana"

todoist_update_task

Actualiza tareas existentes usando búsqueda en lenguaje natural:

• Encuentra tareas por coincidencia parcial de nombre
• Actualiza cualquier atributo de la tarea (contenido, descripción, fecha de vencimiento, prioridad)
• Ejemplo: "Actualiza la tarea de la reunión para que venza el próximo lunes"

todoist_complete_task

Marca tareas como completadas usando búsqueda en lenguaje natural:

• Encuentra tareas por coincidencia parcial de nombre
• Confirma el estado de finalización
• Ejemplo: "Marca la tarea de documentación como completada"

todoist_delete_task

Elimina tareas usando búsqueda en lenguaje natural:

• Encuentra y elimina tareas por nombre
• Mensajes de confirmación
• Ejemplo: "Elimina la tarea de revisión del PR"

Configuración

Obtención de un token de API de Todoist

1. Inicia sesión en tu cuenta de Todoist
2. Navega a Configuración → Integraciones
3. Encuentra tu token de API en "Desarrollador"

Uso con Claude Desktop

Agrega a tu claude_desktop_config.json:

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": ["-y", "@abhiz123/todoist-mcp-server"],
      "env": {
        "TODOIST_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

Ejemplo de uso

Creación de tareas

"Create task 'Team Meeting'"
"Add task 'Review PR' due tomorrow at 2pm"
"Create high priority task 'Fix bug' with description 'Critical performance issue'"

Obtención de tareas

"Show all my tasks"
"List tasks due today"
"Get high priority tasks"
"Show tasks due this week"

Actualización de tareas

"Update documentation task to be due next week"
"Change priority of bug fix task to urgent"
"Add description to team meeting task"

Finalización de tareas

"Mark the PR review task as complete"
"Complete the documentation task"

Eliminación de tareas

"Delete the PR review task"
"Remove meeting prep task"

Desarrollo

Compilación desde el código fuente

# Clone the repository
git clone https://github.com/abhiz123/todoist-mcp-server.git

# Navigate to directory
cd todoist-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar una Solicitud de Extracción (Pull Request).

Licencia

Este proyecto está licenciado bajo la Licencia MIT; consulta el archivo LICENCIA para más detalles.

Problemas y soporte

Si encuentras algún problema o necesitas soporte, por favor reporta un problema en el repositorio de GitHub.