google-tasks-mcp-server by GamaRiverib - MCP Server

Google Tasks MCP Server

Este proyecto implementa un servidor MCP (Model Context Protocol) que expone herramientas para interactuar con la API de Google Tasks. Permite listar, crear, actualizar, eliminar y buscar listas y tareas de Google Tasks mediante herramientas MCP, facilitando su integración con asistentes, agentes o flujos automatizados compatibles con MCP.

Características principales

Autenticación OAuth2 con Google Tasks.
Listado, creación, actualización y eliminación de listas de tareas.
Listado, búsqueda, creación, actualización, finalización, reapertura y eliminación de tareas.
Transporte por stdio para integración sencilla en pipelines o agentes MCP.
Configuración de límites de resultados mediante la variable de entorno MAX_TASK_RESULTS.

Requisitos

Node.js
Una cuenta de Google Cloud Platform con la API de Google Tasks habilitada.
Credenciales OAuth2 descargadas como credentials.json.

Instalación y uso

Instala las dependencias:
```
npm install
```
Coloca tus credenciales OAuth2 en credentials.json en la raíz del proyecto.
Compila el código TypeScript:
```
npx tsc
```
Ejecuta el servidor MCP:
```
node build/index.js
```
La primera vez, se abrirá un flujo de autenticación en el navegador para autorizar el acceso a tu cuenta de Google Tasks.
Integración:
- El servidor MCP se comunica por stdio y expone herramientas como list-task-lists, create-task, update-task, delete-task, entre otras, para ser utilizadas por clientes MCP.

Ejemplo de configuración en Claude Desktop

Para integrar este servidor MCP en Claude Desktop, agrega una entrada en tu archivo claude_desktop_config.json (o en la sección correspondiente de configuración) como el siguiente ejemplo. Asegúrate de ajustar {RUTA} a la ubicación real de tu proyecto:

{
  "mcp_servers": [
    {
      "id": "google-tasks",
      "name": "Google Tasks MCP Server",
      "description": "Servidor MCP para gestionar Google Tasks mediante herramientas MCP.",
      "command": "node",
      "args": [
        "{RUTA}/google-tasks/build/index.js"
      ],
      "env": {
        "MAX_TASK_RESULTS": "100"
      }
    }
  ]
}

Reemplaza {RUTA} por la ruta absoluta donde se encuentra tu proyecto, por ejemplo: D:/Projects/mcp-servers.

Si usas npx, puedes cambiar "command" y "args" así:

"command": "npx",
"args": [
  "@gamariverib/google-tasks"
]

Esto permitirá que Claude Desktop detecte y utilice el servidor MCP de Google Tasks correctamente.

Notas

El archivo token.json se genera automáticamente tras la autenticación y almacena el token de acceso y refresco.
Consulta el código fuente en para ver la definición de cada herramienta y su uso detallado.

GamaRiverib/google-tasks-mcp-server