Servidor MCP de Todoist

Un servidor de Protocolo de Contexto de Modelo (MCP) para Todoist, que permite la gestión avanzada de tareas y proyectos a través de Claude Desktop y otros clientes compatibles con MCP.

Requisitos

• Node.js (se recomienda v18 o superior)

• npm o hilo

• Una cuenta de Todoist

• Un token de API de Todoist (consulte https://todoist.com/prefs/integrations )

Related MCP server: Todoist Python MCP Server

Características

• Enumerar, crear, actualizar, completar, reabrir y eliminar tareas

• Enumerar, crear, actualizar, archivar, desarchivar y eliminar proyectos

• Enumerar, crear, actualizar y eliminar secciones

• Enumerar, crear, actualizar y eliminar etiquetas

• Enumerar, crear, actualizar y eliminar comentarios

• Administrar etiquetas compartidas

• Obtener colaboradores del proyecto

Todas las funciones

• Tareas : enumerar, obtener, crear, actualizar, completar, reabrir, eliminar

• Proyectos : Listar, obtener, crear, actualizar, archivar, desarchivar, eliminar

• Secciones : Lista (por proyecto), obtener, crear, actualizar, eliminar

• Etiquetas : Listar, obtener, crear, actualizar, eliminar, administrar etiquetas compartidas

• Comentarios : Lista (por tarea/proyecto), obtener, crear, actualizar, eliminar

• Colaboradores : Lista de colaboradores del proyecto

Instalación

Para Claude Desktop (JSON)

Si se publica como un paquete npm, puedes usarlo directamente con npx en tu configuración de Claude Desktop:

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": [
        "todoist-mcp"
      ],
      "env": {
        "TODOIST_API_TOKEN": "your_todoist_token"
      }
    }
  }
}

• Establezca TODOIST_API_TOKEN como se muestra.

Instalación manual

1. Clonar el repositorio:

   git clone https://github.com/yourusername/todoist-mcp.git
   cd todoist-mcp

2. Instalar dependencias:

   npm install
   # or
   yarn install

3. Construir el proyecto:

   npm run build
   # or
   yarn build

4. Establezca su token de API de Todoist como una variable de entorno (ver arriba).

5. Ejecute el servidor compilado:

   node dist/server.js

6. Configure Claude Desktop para usar su compilación local agregando esto a su archivo de configuración:

   {
     "mcpServers": {
       "todoist": {
         "command": "node",
         "args": [
           "/path/to/todoist-mcp/dist/server.js"
         ],
         "env": {
           "TODOIST_API_TOKEN": "your_todoist_token"
         }
       }
     }
   }

Ejemplos de uso

• Obtener tareas de máxima prioridad:

  "Muéstrame mis tareas más prioritarias"

• Crear y clasificar etiquetas:

  "Crea etiquetas para mis tareas y clasifícalas por proyecto o urgencia."

• Organizar tareas por sección:

  "Mueva todas las tareas con la etiqueta 'urgente' a la sección 'Hoy'."

• Gestión de proyectos:

  "Crea un nuevo proyecto llamado 'Crecimiento personal' y agrega una sección 'Lista de lectura'."

• Descripción general del colaborador:

  "Enumere todos los colaboradores del proyecto 'Lanzamiento del equipo'."

• Gestión de comentarios:

  Añade un comentario a la tarea "Preparar diapositivas" con el contenido "Recuerda incluir los resultados del segundo trimestre".

Licencia

Este proyecto está licenciado bajo la licencia MIT. Consulte la LICENCIA para más detalles.