Servidor MCP de Todoist
Una implementación de servidor MCP (Protocolo de Contexto de Modelo) que integra Claude con Todoist, lo que permite la gestión de tareas en lenguaje natural. Este servidor permite a Claude interactuar con tus tareas de Todoist con lenguaje cotidiano.
Características
- Gestión de tareas en lenguaje natural : cree, actualice, complete y elimine tareas utilizando lenguaje cotidiano
- Búsqueda inteligente de tareas : encuentre tareas usando coincidencias de nombres parciales
- Filtrado flexible : filtre tareas por fecha de vencimiento, prioridad y otros atributos
- Detalles de tareas enriquecidos : soporte para descripciones, fechas de vencimiento y niveles de prioridad
- Manejo intuitivo de errores : comentarios claros para una mejor experiencia del usuario
Instalación
Para instalar Todoist MCP Server para Claude Desktop automáticamente a través de Smithery :
npx -y @smithery/cli install @abhiz123/todoist-mcp-server --client claude
Instalación manual
npm install -g @abhiz123/todoist-mcp-server
Herramientas
todoist_crear_tarea
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: "Crear tarea 'Reunión de equipo' con descripción 'Sincronización semanal' con vencimiento mañana"
todoist_obtener_tareas
Recuperar y filtrar tareas:
- Filtrar por fecha de vencimiento, prioridad o proyecto
- Filtrado de fechas en lenguaje natural
- Límite de resultados opcional
- Ejemplo: "Mostrar tareas de alta prioridad con vencimiento esta semana"
tarea_de_actualización_de_todoist
Actualizar tareas existentes mediante la búsqueda en lenguaje natural:
- Buscar tareas por coincidencia parcial de nombre
- Actualizar cualquier atributo de la tarea (contenido, descripción, fecha de vencimiento, prioridad)
- Ejemplo: "Actualizar la tarea de la reunión que vence el próximo lunes"
tarea_completa_de_todoist
Marcar tareas como completadas mediante la búsqueda en lenguaje natural:
- Buscar tareas por coincidencia parcial de nombre
- Confirmar el estado de finalización
- Ejemplo: "Marcar la tarea de documentación como completada"
todoist_eliminar_tarea
Eliminar tareas mediante la búsqueda en lenguaje natural:
- Buscar y eliminar tareas por nombre
- Mensajes de confirmación
- Ejemplo: "Eliminar la tarea de revisión de relaciones públicas"
Configuración
Obtener un token de API de Todoist
- Inicia sesión en tu cuenta de Todoist
- Vaya a Configuración → Integraciones
- Encuentra tu token de API en "Desarrollador"
Uso con Claude Desktop
Añade 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'"
Obtener 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"
Completar tareas
"Mark the PR review task as complete"
"Complete the documentation task"
Eliminar tareas
"Delete the PR review task"
"Remove meeting prep task"
Desarrollo
Construyendo desde la 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
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 .