Google Tasks MCP Server

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Allows listing, reading, searching, creating, updating, and deleting tasks in Google Tasks. Supports accessing task details including title, status, due date, notes, and other metadata.

Servidor MCP de Google Tasks

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

Componentes

Herramientas

  • buscar
    • Buscar tareas en Google Tasks
    • Entrada: query (cadena): Consulta de búsqueda
    • Devuelve tareas coincidentes con detalles
  • lista
    • Enumerar todas las tareas en Google Tasks
    • Entrada opcional: cursor (cadena): Cursor para paginación
    • Devuelve una lista de todas las tareas
  • crear
    • Crear una nueva tarea en Google Tasks
    • Aporte:
      • 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 la confirmación de la creación de la tarea.
  • actualizar
    • Actualizar una tarea existente en Google Tasks
    • Aporte:
      • taskListId (cadena, opcional): ID de la lista de tareas
      • id (cadena, obligatoria): ID de la tarea
      • uri (cadena, obligatoria): URI de la tarea
      • title (cadena, opcional): nuevo título de la tarea
      • notes (cadena, opcional): Nuevas notas de tarea
      • status (cadena, opcional): nuevo estado de la tarea ("necesitaAcción" o "completada")
      • due (cadena, opcional): Nueva fecha de vencimiento
    • Devuelve la confirmación de la actualización de la tarea.
  • borrar
    • Eliminar una tarea en Google Tasks
    • Aporte:
      • taskListId (cadena, obligatoria): ID de la lista de tareas
      • id (cadena, obligatoria): ID de la tarea
    • Devuelve la confirmación de la eliminación de la tarea.
  • claro
    • Borrar tareas completadas de una lista de tareas de Google Tasks
    • Entrada: taskListId (cadena, obligatoria): ID de la lista de tareas
    • Devuelve la confirmación de las tareas completadas

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 puede enumerar, leer, crear, actualizar y eliminar utilizando las herramientas proporcionadas.

Empezando

  1. Crear un nuevo proyecto de Google Cloud
  2. Habilitar la API de Google Tasks
  3. Configurar una pantalla de consentimiento de OAuth ("interna" es adecuada para realizar pruebas)
  4. Agregar ámbitos https://www.googleapis.com/auth/tasks
  5. Cree un ID de cliente OAuth para el tipo de aplicación "Aplicación de escritorio"
  6. Descargue el archivo JSON de las claves OAuth de su cliente
  7. Cambie el nombre del archivo de clave a gcp-oauth.keys.json y colóquelo en la raíz de este repositorio (es decir, gcp-oauth.keys.json )

Asegúrese de construir el servidor con npm run build o npm run watch .

Instalación mediante herrería

Para instalar Google Tasks Server para Claude Desktop automáticamente a través de Smithery :

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

Autenticación

Para autenticar y guardar credenciales:

  1. Ejecute el servidor con el argumento auth : npm run start auth
  2. Esto abrirá un flujo de autenticación en el navegador de su sistema.
  3. Completar 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, agregue lo siguiente a la configuración del servidor de su aplicación:

{ "mcpServers": { "gtasks": { "command": "/opt/homebrew/bin/node", "args": [ "{ABSOLUTE PATH TO FILE HERE}/dist/index.js" ] } } }
-
security - not tested
A
license - permissive license
-
quality - not tested

Se integra con Google Tasks para permitir enumerar, leer, buscar, crear, actualizar y eliminar tareas.

  1. Components
    1. Tools
    2. Resources
  2. Getting started
    1. Installing via Smithery
    2. Authentication
    3. Usage with Desktop App
ID: 1tqi5yij3g