Skip to main content
Glama

Todoist Python MCP Server

by Johnxjp

Servidor MCP de Todoist

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite a clientes como Claude interactuar con Todoist, lo que permite la gestión de tareas mediante lenguaje natural. El servidor actúa como intermediario entre los clientes y la API de Todoist, gestionando la autenticación, la transformación de datos y el procesamiento de comandos. Esta es una versión de Python.

Características

  • Creación de tareas : crea nuevas tareas con el contenido requerido y atributos opcionales
  • Recuperación de tareas : obtenga tareas por ID o enumere tareas con opciones de filtrado
  • Gestión de tareas : actualizar atributos de tareas, marcar tareas como completadas, eliminar tareas

Prerrequisitos

  • Python 3.12
  • ultravioleta
  • Una cuenta Todoist y un token API

Cómo obtener el token API de Todoist

  1. Inicia sesión en tu cuenta de Todoist
  2. Vaya a Configuración de usuario -> Integraciones -> Desarrollador
  3. Copiar token de API

Uso con Claude Desktop

Ejecutar a través de UVX (sin clonación)

Puedes ejecutar el servidor directamente desde GitHub usando UVX:

uvx --from https://github.com/Johnxjp/todoist-mcp-python.git mcp-server-todoist

Luego agrega esta configuración a tu configuración de Claude:

{ "mcpServers": { "todoist-server": { "command": "uvx", "args": [ "--from", "https://github.com/Johnxjp/todoist-mcp-python.git", "mcp-server-todoist" ], "env": { "TODOIST_API_TOKEN": "YOUR_API_TOKEN" } } } }

Ejecutar desde el repositorio clonado

Si prefiere clonar el repositorio, utilice estos comandos:

git clone git@github.com:Johnxjp/todoist-mcp-python.git

Luego agrega a tu archivo de configuración de Claude:

{ "mcpServers": { "todoist-server": { "command": "uv", "args": [ "run", "--with", "mcp[cli]", "--with", "todoist_api_python", "mcp", "run", "/full/path/to/todoist_server.py" ], "env": { "TODOIST_API_TOKEN": "YOUR_API_TOKEN" } } } }

Herramientas disponibles

El servidor proporciona las siguientes herramientas para que Claude las utilice:

  1. create_task : Crea una nueva tarea en Todoist
    • Requerido: contenido (título de la tarea)
    • Opcional:
      • descripción,
      • fecha de vencimiento,
      • prioridad,
      • id_del_proyecto,
      • id_de_sección,
      • etiquetas
  2. get_tasks : Obtenga una lista de tareas e ID de Todoist con varios filtros
    • Opcional:
      • id_del_proyecto,
      • nombre_del_proyecto,
      • nombre_de_tarea,
      • prioridad,
      • etiquetas,
      • está_vencido,
      • límite
  3. update_task : Actualizar una tarea existente buscándola por nombre
    • Obligatorio: task_id
    • Opcional:
      • contenido,
      • descripción,
      • etiquetas,
      • prioridad,
      • fecha_de_vencimiento (AAAA-MM-DD),
      • fecha_límite (AAAA-MM-DD)
  4. delete_task : Eliminar una tarea buscándola por nombre
    • Obligatorio: task_id
  5. complete_task : Marcar una tarea como completa buscándola por nombre
    • Obligatorio: task_id

Ejemplos de interacciones

A continuación se muestran algunos ejemplos de cómo Claude puede interactuar con Todoist a través de este servidor MCP:

  • "Añadir una tarea para comprar comestibles"
  • "Muéstrame todas mis tareas urgentes"
  • "¿Qué tareas hay que realizar hoy?"
  • Marcar la tarea de lavandería como realizada
  • Cambiar la prioridad de mi cita con el dentista a urgente

Consideraciones de seguridad

  • El servidor maneja de forma segura su token de API de Todoist a través de variables de entorno
  • Nunca comparta su archivo .env ni exponga su token API
  • El servidor se ejecuta localmente y se comunica únicamente con la API de Todoist

Licencia

Licencia MIT

Expresiones de gratitud

-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Un servidor de perfiles de contexto de modelo que permite a Claude interactuar con Todoist, permitiendo a los usuarios crear, recuperar, actualizar y administrar tareas a través de comandos de lenguaje natural.

  1. Características
    1. Prerrequisitos
      1. Cómo obtener el token API de Todoist
    2. Uso con Claude Desktop
      1. Ejecutar a través de UVX (sin clonación)
        1. Ejecutar desde el repositorio clonado
          1. Herramientas disponibles
            1. Ejemplos de interacciones
              1. Consideraciones de seguridad
                1. Licencia
                  1. Expresiones de gratitud

                    Related MCP Servers

                    • A
                      security
                      A
                      license
                      A
                      quality
                      An MCP server that integrates Claude with Todoist, enabling natural language task management including creating, updating, completing, and deleting tasks.
                      Last updated -
                      5
                      245
                      153
                      JavaScript
                      MIT License
                    • -
                      security
                      A
                      license
                      -
                      quality
                      A Model Context Protocol server that integrates with Notion's API to manage personal todo lists, allowing users to view, add, and update tasks directly from Claude.
                      Last updated -
                      13
                      Python
                      MIT License
                    • A
                      security
                      A
                      license
                      A
                      quality
                      A Model Context Protocol server that bridges Claude with Google Tasks, allowing users to manage task lists and tasks directly through Claude interface.
                      Last updated -
                      15
                      9
                      TypeScript
                      MIT License
                      • Apple
                    • A
                      security
                      F
                      license
                      A
                      quality
                      A Model Context Protocol service for Claude that enables natural language interaction with Microsoft Todo tasks, including viewing task lists, creating tasks, and managing checklist items.
                      Last updated -
                      13
                      111
                      3
                      TypeScript
                      • Apple
                      • Linux

                    View all related MCP servers

                    MCP directory API

                    We provide all the information about MCP servers via our MCP API.

                    curl -X GET 'https://glama.ai/api/mcp/v1/servers/Johnxjp/todoist-mcp-python'

                    If you have feedback or need assistance with the MCP directory API, please join our Discord server