Servidor MCP de Google Tasks

Este servidor del Protocolo de Contexto de Modelo (MCP) proporciona un puente entre los clientes MCP y Google Tasks, permitiéndote gestionar tus listas de tareas y tareas directamente desde clientes como Claude Desktop, Cursor y Codex.

Características

Este servidor MCP proporciona la siguiente funcionalidad:

Gestión de listas de tareas

• list-tasklists - Lista todas tus listas de tareas

• get-tasklist - Obtiene detalles sobre una lista de tareas específica

• create-tasklist - Crea una nueva lista de tareas

• update-tasklist - Actualiza una lista de tareas existente

• delete-tasklist - Elimina una lista de tareas

Gestión de tareas

• list-tasks - Lista todas las tareas en una lista de tareas, incluyendo resultados paginados

• get-task - Obtiene detalles sobre una tarea específica

• create-task - Crea una nueva tarea

• update-task - Actualiza una tarea existente

• delete-task - Elimina una tarea

• complete-task - Marca una tarea como completada

• move-task - Mueve una tarea (reordenar, cambiar padre o mover entre listas de tareas)

• clear-completed-tasks - Borra todas las tareas completadas de una lista

Related MCP server: Google Search MCP Server

Instrucciones de configuración

1. Crear proyecto en Google Cloud y habilitar la API

1. Ve a la Consola de Google Cloud

2. Crea un nuevo proyecto

3. Navega a "APIs y servicios" > "Biblioteca"

4. Busca "Google Tasks API" y habilítala

5. Ve a "APIs y servicios" > "Credenciales"

6. Haz clic en "Crear credenciales" > "ID de cliente de OAuth"

7. Configura la pantalla de consentimiento de OAuth (la opción "Externa" es adecuada para uso personal)

8. Para el tipo de aplicación, selecciona "Aplicación web"

9. Añade "http://localhost:3000/oauth2callback" como URI de redireccionamiento autorizado

10. Crea el ID de cliente y el secreto

2. Configurar variables de entorno

Crea un archivo .env en el directorio de este proyecto:

GOOGLE_CLIENT_ID=your_client_id_here
GOOGLE_CLIENT_SECRET=your_client_secret_here
GOOGLE_REDIRECT_URI=http://localhost:3000/oauth2callback

Variables de entorno:

• GOOGLE_CLIENT_ID (obligatorio) - Tu ID de cliente de OAuth de Google

• GOOGLE_CLIENT_SECRET (obligatorio) - Tu secreto de cliente de OAuth de Google

• GOOGLE_REDIRECT_URI (opcional) - URI de redireccionamiento de OAuth (por defecto es http://localhost:3000/oauth2callback)

Nota: El servidor valida que GOOGLE_CLIENT_ID y GOOGLE_CLIENT_SECRET estén configurados al iniciarse y fallará con mensajes de error claros si faltan o no son válidos.

3. Construir el servidor

1. Instala las dependencias:

npm install

2. Construye el servidor:

npm run build

4. Configurar un cliente MCP

Codex

Añade el servidor a ~/.codex/config.toml:

[mcp_servers.google-tasks]
command = "zsh"
args = ["-lc", "cd /path/to/google-tasks-mcp && exec node build/index.js"]

Reemplaza /path/to/google-tasks-mcp con la ruta a este proyecto, luego reinicia Codex.

Para verificar que el servidor está registrado:

codex mcp list
codex mcp get google-tasks

Claude for Desktop

1. Instala Claude for Desktop

2. Abre el archivo de configuración de Claude:

   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

3. Añade la configuración del servidor MCP de Google Tasks:

{
  "mcpServers": {
    "google-tasks": {
      "command": "node",
      "args": ["/path/to/google-tasks-mcp/build/index.js"]
    }
  }
}

Reemplaza la ruta con tu propio valor, luego reinicia Claude for Desktop.

Flujo de autenticación

Cuando utilices el servidor MCP de Google Tasks por primera vez:

1. Usa la herramienta authenticate para obtener una URL de autorización

2. Visita la URL en tu navegador e inicia sesión con tu cuenta de Google

3. Después de autorizar, recibirás un código en la página del navegador

4. Usa la herramienta set-auth-code con este código para completar la autenticación

5. Ahora puedes usar todas las demás herramientas para interactuar con Google Tasks

Nota: Tus tokens de autenticación (incluyendo los tokens de actualización) se guardan automáticamente en el disco en ~/.config/google-tasks-mcp/credentials.json con permisos restringidos (600). Esto significa:

• Solo necesitas autenticarte una vez - las credenciales persisten tras reiniciar el servidor

• Actualización automática de tokens - Los tokens de acceso se actualizan automáticamente cuando caducan (normalmente después de 1 hora) usando el token de actualización guardado

• No se requiere re-autenticación - Después de la configuración inicial, no necesitarás autenticarte de nuevo a menos que revoques el acceso o elimines el archivo de credenciales

Requisitos

• Node.js 20+ (consulta los motores en package.json)

• Un cliente compatible con MCP

• Proyecto de Google Cloud con la API de Tasks habilitada

Características de implementación

Este servidor MCP incluye las siguientes mejoras:

• Almacenamiento persistente de tokens - Las credenciales de autenticación se guardan en el disco (~/.config/google-tasks-mcp/credentials.json) con permisos restringidos, por lo que solo necesitas autenticarte una vez

• Validación de variables de entorno - La validación al inicio asegura que las credenciales requeridas estén configuradas con mensajes de error claros

• Actualización automática de tokens - Los tokens de OAuth se actualizan automáticamente cuando caducan, eliminando la necesidad de re-autenticarse durante sesiones activas o después de reinicios

• Validación de entrada mejorada - Validación exhaustiva de todas las entradas, incluyendo formatos de ID, longitudes de cadena y formatos de fecha RFC 3339

• Sanitización HTML - Las respuestas de devolución de llamada de OAuth se sanitizan para prevenir vulnerabilidades XSS

• Apagado elegante - Limpieza adecuada de recursos ante señales SIGINT/SIGTERM

• Seguridad de tipos - Seguridad de tipos completa con TypeScript en toda la base de código con interfaces adecuadas

• URI de redireccionamiento configurable - La URI de redireccionamiento de OAuth se puede personalizar a través de la variable de entorno GOOGLE_REDIRECT_URI

Capturas de pantalla

Claude Desktop

Cursor

Licencia

Este proyecto es solo para fines de demostración. Úsalo bajo tu propia responsabilidad.