Google Tasks MCP

Un servidor MCP que permite a los agentes de IA leer y administrar las tareas de Google de un usuario. Usa la API oficial de Google Tasks, credenciales OAuth 2.0 de aplicación de escritorio y el SDK de MCP de TypeScript mediante stdio.

Características

• Enumerar, inspeccionar, crear, renombrar y eliminar listas de tareas

• Enumerar y filtrar tareas con paginación de la API

• Crear, editar, completar, reabrir, mover, reordenar y eliminar tareas

• Crear y mover subtareas mediante parent y previous

• Borrar las tareas completadas

• Anotaciones de seguridad de MCP además de confirmación explícita para operaciones destructivas

• Token de actualización de OAuth almacenado fuera del repositorio con permisos exclusivos del propietario

Requisitos

• Node.js 20 o superior

• Una cuenta de Google

• Un proyecto de Google Cloud con la API de Google Tasks habilitada

1. Configurar Google Cloud

1. Abra Google Cloud Console.

2. Cree o seleccione un proyecto.

3. Habilite Google Tasks API en APIs & Services → Library.

4. Configure la pantalla de consentimiento de OAuth.

5. En APIs & Services → Credentials, cree un ID de cliente de OAuth con el tipo de aplicación Desktop app.

6. Descargue el JSON del cliente de escritorio de OAuth como client_secret.json y manténgalo protegido fuera de este repositorio.

2. Instalar, compilar y autorizar

npm install
npm run build
npm run auth -- --client-secret /secure/google/client_secret.json

El comando de autenticación acepta únicamente un JSON de cliente OAuth de escritorio que contenga el objeto installed de nivel superior. Abre el flujo de consentimiento en el navegador y guarda el token de actualización de Tasks en:

~/.config/google-tasks-mcp/token.json

Sobrescriba la ubicación del token generado cuando sea necesario:

GOOGLE_TOKEN_FILE=/secure/google/tasks-token.json \
npm run auth -- --client-secret /secure/google/client_secret.json

Para un paquete instalado, ejecute:

google-tasks-mcp-auth --client-secret /secure/google/client_secret.json

El servidor solicita el alcance completo https://www.googleapis.com/auth/tasks porque expone tanto operaciones de lectura como de escritura. Las ejecuciones posteriores del servidor MCP usan el token almacenado y renuevan el acceso automáticamente; vuelva a proporcionar client_secret.json únicamente cuando deba autorizar o volver a autorizar el proyecto. Nunca haga commit de ninguno de los dos archivos JSON.

3. Conectar un host MCP

Use el servidor compilado directamente desde esta copia del repositorio. Reemplace las rutas por rutas absolutas en su máquina.

Codex (~/.codex/config.toml)

[mcp_servers.google_tasks]
command = "node"
args = ["/absolute/path/google-task-mcp/dist/index.js"]

[mcp_servers.google_tasks.env]
GOOGLE_TOKEN_FILE = "/Users/you/.config/google-tasks-mcp/token.json"

Hosts que usan configuración JSON

{
  "mcpServers": {
    "google_tasks": {
      "command": "node",
      "args": ["/absolute/path/google-task-mcp/dist/index.js"],
      "env": {
        "GOOGLE_TOKEN_FILE": "/Users/you/.config/google-tasks-mcp/token.json"
      }
    }
  }
}

Reinicie el host de MCP después de cambiar su configuración.

Herramientas disponibles

Google Tasks almacena solo la parte de fecha de una marca temporal de vencimiento. La hora del día que se envía a través de la API se descarta. Los títulos de las tareas están limitados a 1.024 caracteres y las notas, a 8.192 caracteres.

Probar con MCP Inspector

npm run build
npm run inspect

El protocolo stdio usa stdout exclusivamente. Los diagnósticos de tiempo de ejecución se escriben por lo tanto en stderr.

Empaquetar para distribución

Cree un tarball npm instalable:

npm pack

Después de publicar el paquete, un host puede lanzarlo con:

{
  "command": "npx",
  "args": ["-y", "google-tasks-mcp@0.1.0"],
  "env": {
    "GOOGLE_TOKEN_FILE": "/secure/google/tasks-token.json"
  }
}

Para un único usuario en una estación de trabajo, stdio más un token local es el despliegue más sencillo y seguro. Para varios usuarios o un servicio alojado, use MCP Streamable HTTP e implemente sesiones OAuth por usuario y almacenamiento cifrado de tokens en el servidor; no comparta un mismo token de actualización entre usuarios.

Referencias

• Referencia REST de la API de Google Tasks

• Campos de recursos de Google Tasks

• Orden de Google Tasks

• Google OAuth 2.0

• MCP TypeScript SDK