Skip to main content
Glama
Todoist MCP Server

Todoist MCP Server

by abhiz123

Servidor MCP de Todoist

insignia de herrería

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

Related MCP server: Enhanced Todoist MCP Server Extended

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

  1. Inicia sesión en tu cuenta de Todoist

  2. Vaya a Configuración → Integraciones

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

Available Tools

5 tools
todoist_complete_taskB

Mark a task as complete by searching for it by name

Inputs: task_name (required).

todoist_create_taskB

Create a new task in Todoist with optional description, due date, and priority

Inputs: content (required), priority, due_string, description.

todoist_delete_taskB

Delete a task from Todoist by searching for it by name

Inputs: task_name (required).

todoist_get_tasksA

Get a list of tasks from Todoist with various filters

Inputs: limit, filter, priority, project_id.

todoist_update_taskB

Update an existing task in Todoist by searching for it by name and then updating it

Inputs: task_name (required), content, priority, due_string, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool targets a distinct operation (create, read, update, delete, complete) on tasks, with no overlap. The descriptions clearly differentiate the actions.

    Naming Consistency5/5

    All tools follow a consistent 'todoist_verb_task' pattern (e.g., todoist_complete_task, todoist_create_task), using snake_case and clear verbs.

    Tool Count5/5

    With 5 tools, the set covers the essential CRUD operations plus a completion action, which is appropriate for a task management server. No excessive or missing tools.

    Completeness4/5

    The tools cover full CRUD (create, get, update, delete) and a common operation (complete), which is sufficient for basic task management. Minor gaps like reordering or sharing tasks are not critical.

    Maintenance

    ActivityInactive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers