Todoist

Gestiona tareas, proyectos, etiquetas y comentarios en Todoist usando su API.

Documentación

Servidor MCP de Todoist

Un servidor de Model Context Protocol (MCP) que proporciona herramientas para interactuar con Todoist, permitiendo a los asistentes de IA gestionar tareas, proyectos, etiquetas, secciones y comentarios a través de la API de Todoist.

Configuración

Este servidor requiere un token de API de Todoist para funcionar.

  1. Obtén tu token de API:

  2. Configura tu cliente MCP: Añade el servidor a la configuración de tu cliente MCP, asegurándote de incluir tu token de API. Para Claude Desktop, añadirías uno de los siguientes a tu claude_desktop_config.json:

    Docker

    {
      "mcpServers": {
        "todoist": {
          "command": "docker",
          "args": [
            "run",
            "-i",
            "--rm",
            "-e",
            "TODOIST_API_TOKEN=your_api_token_here",
            "ghcr.io/ganievs/todoist-mcp-server:latest"
          ]
        }
      }
    }
    

    NPX

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

Uso

Una vez configurado, puedes usar lenguaje natural para interactuar con Todoist a través de tu cliente MCP:

  • "Crea una tarea para comprar víveres con prioridad alta"
  • "Lista todos mis proyectos"
  • "Añade un comentario a la tarea sobre la reunión"
  • "Crea un nuevo proyecto para mi planificación de vacaciones"
  • "Muéstrame todas las tareas con la etiqueta 'urgente'"

Desarrollo

Para configurar el proyecto para desarrollo:

  1. Clona el repositorio:

    git clone https://github.com/ganievs/todoist-mcp-server.git
    cd todoist-mcp-server
    
  2. Instala las dependencias:

    npm install
    
  3. Ejecuta el linter:

    npm run lint
    
  4. Compila el proyecto:

    npm run build
    

Soporte

Para problemas y solicitudes de funciones, utiliza la página de GitHub Issues.