Integrations

Enables managing Todoist tasks, projects, and labels. Provides tools for creating, updating, completing, and deleting tasks; organizing tasks in projects and with labels; and searching and filtering tasks based on various criteria.

MCP Todoist

Un servidor de Protocolo de contexto de modelo (MCP) que permite a Claude interactuar con tu cuenta Todoist.

Características

Administrar tareas: crear, actualizar, completar y eliminar tareas
Organiza tareas en proyectos y con etiquetas
Buscar y filtrar tareas según diversos criterios
Integración perfecta con Claude Desktop

Prerrequisitos

Python 3.11+
UV astral
Cuenta Todoist y token API
Claude Desktop (para utilizar el servidor MCP)

Inicio rápido

1. Instalación

# Install using UV
uvx mcp-todoist

2. Configuración

Obtén tu token de API de Todoist desde la configuración de Integraciones de Todoist
Configurar la variable de entorno:
# Add to your .env file or environment TODOIST_API_TOKEN=your_api_token_here
Configurar Claude Desktop:
// ~/.config/claude/claude_desktop_config.json or equivalent { "mcpServers": { "mcp-todoist": { "command": "uvx", "args": ["mcp-todoist"] } } }

3. Uso con Claude

Una vez configurado, puedes pedirle a Claude que interactúe con tu cuenta Todoist:

"Muéstrame mis tareas que vencen hoy"
"Crea una nueva tarea para comprar comida mañana"
Marcar mi tarea de 'enviar correo electrónico' como completada
"Crear un nuevo proyecto llamado 'Renovación de Vivienda'"
"Muéstrame todas las tareas en mi proyecto de Trabajo"

Herramientas disponibles

Gestión de tareas

list-tasks - Recuperar y filtrar tareas
create-task - Crea una nueva tarea
update-task - Actualizar una tarea existente
complete-task - Marcar una tarea como completada
delete-task - Eliminar una tarea

Gestión de proyectos

list-projects - Obtener todos los proyectos
create-project - Crea un nuevo proyecto
update-project - Actualizar un proyecto
delete-project - Eliminar un proyecto

Gestión de etiquetas

list-labels - Obtener todas las etiquetas
create-label - Crea una nueva etiqueta
update-label - Actualizar una etiqueta
delete-label - Eliminar una etiqueta

Servicios públicos

search : busque en todas las tareas con filtrado complejo

Ejecución del servidor MCP

Hay varias formas de ejecutar el servidor MCP de Todoist:

Método 1: Línea de comando directa

Ejecute el servidor en una ventana de terminal:

# Set your API token
export TODOIST_API_TOKEN=your_api_token_here

# Run the server using UV
uvx mcp-todoist

# Alternative: Run from source
cd /path/to/mcp-todoist
uv run python -m mcp_todoist

Mantenga esta ventana de terminal abierta mientras utiliza Claude Desktop.

Método 2: Usar un script de inicio (recomendado)

Cree un script de inicio que Claude Desktop pueda usar para iniciar automáticamente el servidor:

Crea un archivo llamado start-todoist-mcp.sh con el siguiente contenido:

#!/bin/bash

# Set environment variables
export MCP_SERVER_NAME="mcp-todoist"
export MCP_LOG_LEVEL="INFO"
export MCP_DEBUG="true"
export TODOIST_API_TOKEN="your_todoist_api_token_here"

# Path to your Todoist MCP server
MCP_PATH="/path/to/mcp-todoist"

# Log file for debugging
LOG_FILE="${MCP_PATH}/todoist-mcp.log"

# Create log file or clear existing one
echo "Starting Todoist MCP server at $(date)" > "${LOG_FILE}"

# Navigate to the project directory
cd "${MCP_PATH}"

# Start the MCP server
echo "Starting MCP server from ${MCP_PATH}" >> "${LOG_FILE}"
uv run python -m mcp_todoist >> "${LOG_FILE}" 2>&1

Hacer que el script sea ejecutable:

chmod +x start-todoist-mcp.sh

Actualice la configuración de Claude Desktop para utilizar este script:

{
  "mcpServers": {
    "mcp-todoist": {
      "command": "/absolute/path/to/start-todoist-mcp.sh",
      "args": []
    }
  }
}

Este enfoque ofrece varias ventajas:

El servidor se inicia automáticamente con Claude Desktop
Todos los registros se capturan en un archivo para facilitar la depuración.
Las variables de entorno se establecen de forma consistente

Depuración

Si encuentra problemas con el servidor MCP, aquí hay algunas estrategias de depuración:

1. Verifique los registros

Si utiliza el script de inicio, verifique el archivo de registro:

cat /path/to/mcp-todoist/todoist-mcp.log

2. Habilitar el modo de depuración

Establezca la variable de entorno MCP_DEBUG en true para un registro más detallado:

export MCP_DEBUG=true
uvx mcp-todoist

3. Verificar el token de API

Asegúrate de que tu token de API de Todoist sea correcto y siga siendo válido:

# Test the token with a simple curl request
curl -X GET \
  https://api.todoist.com/rest/v2/projects \
  -H "Authorization: Bearer $TODOIST_API_TOKEN"

4. Utilice el Inspector MCP

El Inspector MCP es una herramienta poderosa para depurar servidores MCP:

npx @modelcontextprotocol/inspector uvx mcp-todoist

Esto abrirá una interfaz web que mostrará todas las comunicaciones entre Claude y el servidor MCP.

5. Problemas comunes y soluciones

Error "Servidor MCP no disponible" : asegúrese de que el servidor se esté ejecutando en una terminal separada o mediante un script de inicio.
Errores de autenticación : verifica que tu token de API de Todoist esté configurado correctamente en tu entorno.
Errores de "Comando no encontrado" : asegúrese de que Astral UV esté instalado y en su RUTA.
Errores de tiempo de espera : si su servidor MCP tarda en responder, intente aumentar el tiempo de espera en la configuración de Claude Desktop.

Desarrollo

Configuración

# Clone the repository
git clone https://github.com/yourusername/mcp-todoist.git
cd mcp-todoist

# Install dependencies
uv sync

Pruebas

# Run tests
uv run pytest

Desarrollo local

Para el desarrollo local, puedes crear un archivo .env con tu token de API de Todoist:

TODOIST_API_TOKEN=your_api_token_here

Luego ejecuta el servidor:

uv run python -m mcp_todoist

Licencia

Licencia MIT: consulte el archivo LICENCIA para obtener más detalles.

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Un servidor de protocolo de contexto de modelo que permite a Claude interactuar con tu cuenta Todoist, permitiéndote administrar tareas, proyectos y etiquetas a través del lenguaje natural.

Appeared in Searches

A tool or application for creating a to-do list