todoist-mcp

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.

Integrations

Provides full access to the Todoist REST API v2, enabling task management (create, update, close, reopen, delete), project management, section handling, comment management for tasks and projects, and label management through natural language interactions.

Características

Integración completa de la API de Todoist : acceso a la API REST v2 completa de Todoist y compatibilidad con la API de sincronización de Todoist a través de lenguaje natural
Procesamiento por lotes : el cliente puede procesar múltiples tareas en una sola solicitud
Buscar por nombre : la IA puede buscar tareas, proyectos y etiquetas por nombre en lugar de ID
Tareas : crear, actualizar, cerrar, volver a abrir, mover y eliminar tareas utilizando lenguaje conversacional
Proyectos : Crea y gestiona proyectos y secciones
Comentarios : Agregue y administre comentarios sobre tareas y proyectos
Etiquetas : Crea y administra etiquetas personales y compartidas
Soporte rápido : Puede proporcionar fácilmente información sobre sus proyectos al cliente.

Configuración

Necesitará un token de API de Todoist para utilizar este servidor MCP.

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", "todoist-mcp"],
            "env": {
                "API_KEY": "your_todoist_api_token_here"
            }
        }
    }
}

Herramientas disponibles

Tareas

get_tasks_list : Obtener tareas con filtrado opcional por proyecto, sección, etiqueta, etc.
create_tasks : Crea nuevas tareas con varios atributos
get_tasks : Obtener tareas específicas por ID o nombre
update_tasks : Actualizar tareas existentes
close_tasks : Marcar tareas como completadas
reopen_tasks : Reabrir tareas completadas
delete_tasks : Eliminar tareas
move_tasks : Mover tareas a un proyecto o sección diferente

Proyectos

get_projects_list : Obtener todos los proyectos
create_projects : Crea nuevos proyectos
get_projects : Obtener proyectos específicos por ID o nombre
update_projects : Actualizar proyectos existentes
delete_projects : Eliminar proyectos
get_collaborators : Obtener todos los colaboradores de un proyecto
move_projects : Mover proyectos a una ubicación o subproyecto diferente

Secciones

get_sections_list : Obtener todas las secciones o filtrar por proyecto
create_sections : Crea nuevas secciones
get_sections : Obtener secciones específicas por ID o nombre
update_sections : Actualizar secciones
delete_sections : Eliminar secciones

Comentarios

get_comments_list : Obtener comentarios para un proyecto o tarea
create_comments : Crea nuevos comentarios
get_comments : Obtener comentarios específicos por ID
update_comments : Actualizar comentarios
delete_comments : Eliminar comentarios

Etiquetas

get_labels_list : Obtener todas las etiquetas personales
create_labels : Crea nuevas etiquetas personales
get_labels : Obtener etiquetas personales por ID o nombre
update_labels : Actualizar etiquetas personales
delete_labels : Eliminar etiquetas personales
get_shared_labels : Obtener todas las etiquetas compartidas
rename_shared_labels : Cambiar el nombre de las etiquetas compartidas
remove_shared_labels : Eliminar etiquetas compartidas

Utilidades

utils_get_colors : Obtener los colores disponibles para proyectos, etiquetas y filtros

Indicaciones

projects_list : Obtiene la lista de proyectos con sus secciones y parámetros en formato markdown

Ejemplo de uso

Pregúntele a su asistente de IA (como Claude) preguntas como:

"What tasks do I have due today?"
"Create a task to review the quarterly report by next Friday"
"Make a new project called 'Home Renovation'"
"Add a comment to my meeting prep task"
"Show me all my high priority tasks"
"Create a label for 'Urgent' tasks with a red color"
"What projects do I have in my Todoist?"
"Mark my dentist appointment task as complete"

Desarrollo

# Install dependencies
npm install

# Build the project and run inspector
npm run build && npx @modelcontextprotocol/inspector -e API_KEY=YOUR_API_KEY_HERE node dist/index.js

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.

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

API REST v2 completa de Todoist y compatibilidad con la integración de la API de sincronización de Todoist, con soporte para la gestión de tareas, proyectos, secciones, comentarios y etiquetas