gtasks-mcp - Servidor de Protocolo de Contexto de Modelo de Google Tasks

Resumen del Proyecto

gtasks-mcp es un servidor de Protocolo de Contexto de Modelo (MCP) de Google Tasks diseñado específicamente para Claude AI. Este proyecto permite a Claude integrarse directamente con la API de Google Tasks, permitiendo la gestión completa de las tareas de Google.

Dirección del proyecto: https://github.com/zcaceres/gtasks-mcp

Funcionalidades Principales

Herramientas (Tools)

1. search - Buscar tarea

• Descripción de la función: Busca tareas en Google Tasks
• Parámetros de entrada:
  • query (string): Cadena de búsqueda
• Resultado de retorno: Información detallada de las tareas coincidentes

2. list - Listar tareas

• Descripción de la función: Lista todas las tareas en Google Tasks
• Parámetros de entrada:
  • cursor (string, opcional): Cursor de paginación
• Resultado de retorno: Lista de todas las tareas

3. create - Crear tarea

• Descripción de la función: Crea una nueva tarea en Google Tasks
• Parámetros de entrada:
  • taskListId (string, opcional): ID de la lista de tareas
  • title (string, obligatorio): Título de la tarea
  • notes (string, opcional): Notas de la tarea
  • due (string, opcional): Fecha de vencimiento
• Resultado de retorno: Información de confirmación de la creación de la tarea

4. update - Actualizar tarea

• Descripción de la función: Actualiza una tarea existente de Google Tasks
• Parámetros de entrada:
  • taskListId (string, opcional): ID de la lista de tareas
  • id (string, obligatorio): ID de la tarea
  • uri (string, obligatorio): URI de la tarea
  • title (string, opcional): Nuevo título de la tarea
  • notes (string, opcional): Nuevas notas de la tarea
  • status (string, opcional): Nuevo estado de la tarea ("needsAction" o "completed")
  • due (string, opcional): Nueva fecha de vencimiento
• Resultado de retorno: Información de confirmación de la actualización de la tarea

5. delete - Eliminar tarea

• Descripción de la función: Elimina una tarea de Google Tasks
• Parámetros de entrada:
  • taskListId (string, obligatorio): ID de la lista de tareas
  • id (string, obligatorio): ID de la tarea
• Resultado de retorno: Información de confirmación de la eliminación de la tarea

6. clear - Limpiar tareas completadas

• Descripción de la función: Limpia las tareas completadas en una lista de tareas de Google Tasks
• Parámetros de entrada:
  • taskListId (string, obligatorio): ID de la lista de tareas
• Resultado de retorno: Información de confirmación de la operación de limpieza

Recursos (Resources)

El servidor proporciona acceso a los recursos de Google Tasks:

• Recurso de tarea (gtasks:///<task_id>)
  • Representa una sola tarea en Google Tasks
  • Admite la lectura de información detallada de la tarea, incluyendo título, estado, fecha de vencimiento, notas y otros metadatos
  • Se pueden realizar operaciones de listado, lectura, creación, actualización y eliminación utilizando las herramientas proporcionadas

Instalación y Configuración

Requisitos Previos

1. Crear un proyecto de Google Cloud

   • Visita Google Cloud Console para crear un nuevo proyecto

2. Habilitar la API de Google Tasks

   • Habilita la API en Google Cloud Console

3. Configurar la pantalla de consentimiento de OAuth

   • Configura en Pantalla de consentimiento de OAuth
   • Selecciona "internal" para el entorno de prueba
   • Agrega el alcance: https://www.googleapis.com/auth/tasks

4. Crear un ID de cliente OAuth

   • Crea en la Página de credenciales
   • Selecciona "Aplicación de escritorio" como tipo de aplicación
   • Descarga el archivo JSON de la clave OAuth
   • Cambia el nombre del archivo de clave a gcp-oauth.keys.json y colócalo en el directorio raíz del proyecto

Construir el Proyecto

Utiliza el siguiente comando para construir el servidor:

npm run build

O utiliza el modo de escucha:

npm run watch

Instalación Automática (Recomendada)

Instala automáticamente a través de Smithery:

npx -y @smithery/cli install @zcaceres/gtasks --client claude

Autenticación

1. Ejecuta el servidor y autentícate:

npm run start auth

2. Esto abrirá el flujo de autenticación en el navegador del sistema
3. Completa el proceso de autenticación
4. Las credenciales se guardarán en el directorio raíz del proyecto (.gdrive-server-credentials.json)

Integración con Claude Desktop

Para integrar este servidor con la aplicación Claude Desktop, agrega lo siguiente a la configuración del servidor de la aplicación:

{
  "mcpServers": {
    "gtasks": {
      "command": "/opt/homebrew/bin/node",
      "args": [
        "{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
      ]
    }
  }
}

Características Técnicas

• Operaciones CRUD completas: Soporta la creación, lectura, actualización y eliminación de tareas
• Funcionalidad de búsqueda avanzada: Permite buscar tareas por palabras clave
• Gestión del estado de las tareas: Permite marcar las tareas como completadas o pendientes
• Soporte de paginación: Proporciona funcionalidad de paginación para manejar grandes cantidades de tareas
• Autenticación OAuth 2.0: Acceso seguro a la API de Google
• Soporte de TypeScript: Proporciona seguridad de tipos y una mejor experiencia de desarrollo

Casos de Uso

• Gestión de tareas personales: Gestiona las tareas diarias a través de la interacción en lenguaje natural con Claude
• Colaboración en proyectos: Gestiona la asignación de tareas en proyectos de equipo a través de un asistente de IA
• Flujos de trabajo automatizados: Combina con otras herramientas para automatizar la gestión de tareas
• Aumento de la productividad: Crea y actualiza tareas rápidamente a través de la voz o el texto

Precauciones

• Requiere una cuenta de Google válida y acceso a Google Tasks
• El primer uso requiere completar el flujo de autenticación OAuth
• Se recomienda proteger adecuadamente el archivo de credenciales de autenticación en un entorno de producción
• Cumplir con las cuotas y restricciones de uso de la API de Google