gtasks-mcp

Un servidor de Model Context Protocol para Google Tasks: lista, busca, crea, actualiza, elimina y limpia tareas desde Claude (o cualquier cliente compatible con MCP).

Adaptado de zcaceres/gtasks-mcp (MIT), reconstruido en Node/TypeScript puro en lugar de Bun, con las credenciales completamente fuera del repositorio (consulta Seguridad más abajo) y una suite de pruebas completa.

Configuración

1. Crear un cliente OAuth de Google Cloud

1. Ve a la Consola de Google Cloud, crea un proyecto (o reutiliza uno).

2. Habilita la API de Google Tasks (APIs y servicios → Biblioteca).

3. Configura la pantalla de consentimiento de OAuth (Externa es suficiente para uso personal; serás el único usuario de prueba).

4. Crea credenciales → ID de cliente OAuth → Tipo de aplicación Aplicación de escritorio.

5. Descarga el archivo JSON.

2. Instalar el archivo de cliente OAuth

mkdir -p ~/.gtasks-mcp
mv ~/Downloads/client_secret_*.json ~/.gtasks-mcp/oauth-keys.json

En Windows: %USERPROFILE%\.gtasks-mcp\oauth-keys.json.

3. Compilar y autenticar

npm install
npm run build
npm run auth

Esto abre una ventana del navegador para el flujo de consentimiento de Google. Si tiene éxito, se escribe un credentials.json (tu token de acceso/refresco) junto a oauth-keys.json en ~/.gtasks-mcp/.

4. Registrar el servidor con Claude Code

claude mcp add gtasks -- node /absolute/path/to/gtasks-mcp/dist/index.js

Related MCP server: mcp-google-tasks

Herramientas expuestas

Seguridad

• Las credenciales nunca viven dentro de este repositorio. oauth-keys.json (tu cliente OAuth de Google Cloud) y credentials.json (tu token personal de acceso/refresco, generado por npm run auth) se almacenan ambos en ~/.gtasks-mcp/ — el área de configuración de usuario del sistema operativo, no el directorio del proyecto. No hay ningún archivo ignorado por git dentro del repositorio que puedas añadir accidentalmente con git add -f; los secretos no son accesibles desde el árbol de trabajo del repositorio en absoluto. Consulta src/config.ts para las rutas exactas.

• credentials.json equivale a una contraseña para tus Google Tasks: cualquiera que tenga ese archivo puede leer/escribir tus tareas. Trátalo en consecuencia (no lo envíes por correo, no lo pegues en un chat, no lo guardes en un lugar compartido).

• Dependencias: solo @google-cloud/local-auth, googleapis y @modelcontextprotocol/sdk — todas oficiales (Google / Anthropic). Sin telemetría, sin llamadas de red de terceros; cada solicitud va a las propias APIs de Google.

• Vulnerabilidades transitivas conocidas y aceptadas (npm audit, comprobado el 2026-08-25): problemas de severidad moderada en esbuild/vite (herramientas solo de desarrollo, no parte del runtime) y uuid (a través de gaxios/googleapis, sin ruta de entrada de buffer no confiable en el uso real de este servidor). Ambos requieren un salto de versión mayor que rompe la compatibilidad en el upstream para resolverse; revísalo en la próxima auditoría periódica de dependencias en lugar de forzar una actualización no probada.

Desarrollo

npm test        # vitest
npm run lint     # eslint (narrow scope — see eslint.config.js)
npm run typecheck
npm run build