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

Instalación mediante herrería

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 .

Todoist MCP Server

Integrations