Google Tasks

Servidor MCP de Google Tasks

Este servidor MCP se integra con Google Tasks para permitir listar, leer, buscar, crear, actualizar y eliminar tareas.

Componentes

Herramientas

• search

  • Buscar tareas en Google Tasks
  • Entrada: query (cadena): Consulta de búsqueda
  • Devuelve tareas coincidentes con detalles

• list

  • Listar todas las tareas en Google Tasks
  • Entrada opcional: cursor (cadena): Cursor para paginación
  • Devuelve una lista de todas las tareas

• create

  • Crear una nueva tarea en Google Tasks
  • Entrada:
    • taskListId (cadena, opcional): ID de la lista de tareas
    • title (cadena, obligatorio): Título de la tarea
    • notes (cadena, opcional): Notas de la tarea
    • due (cadena, opcional): Fecha de vencimiento
  • Devuelve confirmación de la creación de la tarea

• update

  • Actualizar una tarea existente en Google Tasks
  • Entrada:
    • taskListId (cadena, opcional): ID de la lista de tareas
    • id (cadena, obligatorio): ID de la tarea
    • uri (cadena, obligatorio): URI de la tarea
    • title (cadena, opcional): Nuevo título de la tarea
    • notes (cadena, opcional): Nuevas notas de la tarea
    • status (cadena, opcional): Nuevo estado de la tarea ("needsAction" o "completed")
    • due (cadena, opcional): Nueva fecha de vencimiento
  • Devuelve confirmación de la actualización de la tarea

• delete

  • Eliminar una tarea en Google Tasks
  • Entrada:
    • taskListId (cadena, obligatorio): ID de la lista de tareas
    • id (cadena, obligatorio): ID de la tarea
  • Devuelve confirmación de la eliminación de la tarea

• clear

  • Limpiar tareas completadas de una lista de tareas de Google Tasks
  • Entrada: taskListId (cadena, obligatorio): ID de la lista de tareas
  • Devuelve confirmación de las tareas limpiadas

Recursos

El servidor proporciona acceso a los recursos de Google Tasks:

• Tareas (gtasks:///<task_id>)
  • Representa tareas individuales en Google Tasks
  • Admite la lectura de detalles de la tarea, incluidos título, estado, fecha de vencimiento, notas y otros metadatos
  • Se pueden listar, leer, crear, actualizar y eliminar usando las herramientas proporcionadas

Primeros pasos

1. Crear un nuevo proyecto de Google Cloud
2. Habilitar la API de Google Tasks
3. Configurar una pantalla de consentimiento de OAuth ("internal" es suficiente para pruebas)
4. Agregar los alcances https://www.googleapis.com/auth/tasks
5. Crear un ID de cliente OAuth para el tipo de aplicación "Desktop App"
6. Descargar el archivo JSON de las claves OAuth de tu cliente
7. Renombrar el archivo de claves a gcp-oauth.keys.json y colocarlo en la raíz de este repositorio (es decir, gcp-oauth.keys.json)

Asegúrate de compilar el servidor con npm run build o npm run watch.

Instalación mediante Smithery

Para instalar Google Tasks Server para Claude Desktop automáticamente mediante Smithery:

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

Autenticación

Para autenticarse y guardar las credenciales:

1. Ejecuta el servidor con el argumento auth: npm run start auth
2. Esto abrirá un flujo de autenticación en el navegador de tu sistema
3. Completa el proceso de autenticación
4. Las credenciales se guardarán en la raíz de este repositorio (es decir, .gdrive-server-credentials.json)

Uso con la aplicación de escritorio

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

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