todoist-mcp

Características

• Integración completa con la API de Todoist: Acceso a toda la API REST v2 de Todoist y soporte para la API de sincronización de Todoist mediante lenguaje natural.

• Procesamiento por lotes: El cliente puede procesar múltiples tareas en una sola solicitud.

• Búsqueda por nombre: La IA puede buscar tareas, proyectos y etiquetas por nombre en lugar de por ID.

• Tareas: Crea, actualiza, cierra, reabre, mueve y elimina tareas usando lenguaje conversacional.

• Proyectos: Crea y gestiona proyectos y secciones.

• Comentarios: Añade y gestiona comentarios en tareas y proyectos.

• Etiquetas: Crea y gestiona etiquetas personales y compartidas.

• Contexto inteligente: Al iniciar, proporciona automáticamente tus proyectos y etiquetas a la IA mediante instrucciones del servidor; no se requieren llamadas a herramientas adicionales.

• Soporte de prompts: Puedes proporcionar información fácilmente sobre tus proyectos al cliente.

Related MCP server: Notion API MCP Server

Configuración

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

Obtener un token de API de Todoist

1. Inicia sesión en tu cuenta de Todoist.

2. Navega a Ajustes → Integraciones.

3. Encuentra tu token de API en "Desarrollador".

Uso

Añádelo a mcpServers en la configuración de tu plataforma:

"todoist": {
    "command": "npx",
    "args": ["-y", "todoist-mcp"],
    "env": { "API_KEY": "your_todoist_api_token" }
}

Codex — CLI:

codex mcp add todoist --env API_KEY=your_token -- npx -y todoist-mcp

O añádelo a config.toml:

[mcp_servers.todoist]
command = "npx"
args = ["-y", "todoist-mcp"]

[mcp_servers.todoist.env]
API_KEY = "your_todoist_api_token"

Herramientas disponibles

Tareas

• get_tasks_list: Obtiene tareas con filtrado opcional por proyecto, sección, etiqueta o IDs.

• get_tasks_by_filter: Obtiene tareas usando el lenguaje de filtrado de Todoist (ej. "today", "overdue", "P1 | P2", "#Work & @urgent").

• create_tasks: Crea nuevas tareas con varios atributos.

• get_tasks: Obtiene tareas específicas por ID o nombre.

• update_tasks: Actualiza tareas existentes.

• close_tasks: Marca tareas como completadas.

• reopen_tasks: Reabre tareas completadas.

• delete_tasks: Elimina tareas.

• move_tasks: Mueve tareas a un proyecto o sección diferente.

Proyectos

• get_projects_list: Obtiene todos los proyectos.

• create_projects: Crea nuevos proyectos.

• get_projects: Obtiene proyectos específicos por ID o nombre.

• update_projects: Actualiza proyectos existentes.

• delete_projects: Elimina proyectos.

• get_collaborators: Obtiene todos los colaboradores de un proyecto.

• move_projects: Mueve proyectos a una ubicación o subproyecto diferente.

Secciones

• get_sections_list: Obtiene todas las secciones o filtra por proyecto.

• create_sections: Crea nuevas secciones.

• get_sections: Obtiene secciones específicas por ID o nombre.

• update_sections: Actualiza secciones.

• delete_sections: Elimina secciones.

Comentarios

• get_comments_list: Obtiene comentarios de un proyecto o tarea.

• create_comments: Crea nuevos comentarios.

• get_comments: Obtiene comentarios específicos por ID.

• update_comments: Actualiza comentarios.

• delete_comments: Elimina comentarios.

Etiquetas

• get_labels_list: Obtiene todas las etiquetas personales.

• create_labels: Crea nuevas etiquetas personales.

• get_labels: Obtiene etiquetas personales por ID o nombre.

• update_labels: Actualiza etiquetas personales.

• delete_labels: Elimina etiquetas personales.

• get_shared_labels: Obtiene todas las etiquetas compartidas.

• rename_shared_labels: Cambia el nombre de etiquetas compartidas.

• remove_shared_labels: Elimina etiquetas compartidas.

Utilidades

• utils_get_colors: Obtiene los colores disponibles para proyectos, etiquetas y filtros.

Prompts

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

Ejemplo de uso

Haz preguntas a tu asistente de IA (como Claude) tales 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á bajo la Licencia MIT - consulta el archivo LICENSE para más detalles.

Problemas y soporte

Si encuentras algún problema o necesitas ayuda, por favor abre un issue en el repositorio de GitHub.