Skip to main content
Glama
Sign In
enesjakozh

MCP Todoist

by dkeesey
GitHub
Python
1
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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

Inicio rápido

1. Instalación

# Install using UV uvx mcp-todoist

2. Configuración

  1. Obtén tu token de API de Todoist desde la configuración de Integraciones de Todoist
  2. Configurar la variable de entorno:
    # Add to your .env file or environment TODOIST_API_TOKEN=your_api_token_here
  3. 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:

  1. 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
  1. Hacer que el script sea ejecutable:
chmod +x start-todoist-mcp.sh
  1. 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

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

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.

  1. Características
    1. Prerrequisitos
      1. Inicio rápido
        1. Instalación
        2. Configuración
        3. Uso con Claude
      2. Herramientas disponibles
        1. Gestión de tareas
        2. Gestión de proyectos
        3. Gestión de etiquetas
        4. Servicios públicos
      3. Ejecución del servidor MCP
        1. Método 1: Línea de comando directa
        2. Método 2: Usar un script de inicio (recomendado)
      4. Depuración
        1. Verifique los registros
        2. Habilitar el modo de depuración
        3. Verificar el token de API
        4. Utilice el Inspector MCP
        5. Problemas comunes y soluciones
      5. Desarrollo
        1. Configuración
        2. Pruebas
        3. Desarrollo local
      6. Licencia

        Related MCP Servers

        • Notion MCP

          Badhansen
          -
          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

        • ConnectWise Manage MCP Server

          ethangillani
          -
          security
          A
          license
          -
          quality
          A Model Context Protocol server that enables Claude to interact with the ConnectWise Manage API to perform operations like retrieving, creating, updating, and deleting tickets, companies, contacts, and other entities.
          Last updated -
          JavaScript
          MIT License
          • Apple

        • Todoist Python MCP Server

          Johnxjp
          -
          security
          A
          license
          -
          quality
          A Model Context Profile server that enables Claude to interact with Todoist, allowing users to create, retrieve, update, and manage tasks through natural language commands.
          Last updated -
          1
          Python
          MIT License

        • Google Tasks MCP Server

          arpitbatra123
          -
          security
          A
          license
          -
          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 -
          5
          TypeScript
          MIT License
          • Apple

        View all related MCP servers

        Appeared in Searches

        New 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/dkeesey/todoist-mcp-server'

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