Servidor MCP de Google Tasks

Este servidor de Protocolo de contexto de modelo (MCP) proporciona un puente entre Claude y Google Tasks, lo que le permite administrar sus listas de tareas y tareas directamente a través de Claude.

Nota: Todo el código (salvo algunas ediciones) en este proyecto fue "codificado por vibración" - generado con Claude con instrucciones mías.

Características

Este servidor MCP proporciona la siguiente funcionalidad:

Gestión de listas de tareas

• list-tasklists - Enumera todas tus listas de tareas

• get-tasklist - Obtener detalles sobre una lista de tareas específica

• create-tasklist - Crea una nueva lista de tareas

• update-tasklist - Actualizar una lista de tareas existente

• delete-tasklist - Eliminar una lista de tareas

Gestión de tareas

• list-tasks : enumera todas las tareas en una lista de tareas

• get-task - Obtener detalles sobre una tarea específica

• create-task - Crea una nueva tarea

• update-task - Actualizar una tarea existente

• delete-task - Eliminar una tarea

• complete-task - Marcar una tarea como completada

• move-task - Mover una tarea (reordenar o cambiar la tarea principal)

• clear-completed-tasks - Borra todas las tareas completadas de una lista

Instrucciones de configuración

1. Crear un proyecto de Google Cloud y habilitar la API

1. Vaya a la consola de Google Cloud

2. Crear un nuevo proyecto

3. Vaya a "API y servicios" > "Biblioteca".

4. Busca "Google Tasks API" y habilítala.

5. Vaya a "API y servicios" > "Credenciales".

6. Haga clic en "Crear credenciales" > "ID de cliente OAuth".

7. Configurar la pantalla de consentimiento de OAuth (External es adecuado para uso personal)

8. Para el tipo de aplicación, seleccione "Aplicación web"

9. Agregue " http://localhost:3000 " como URI de redireccionamiento autorizado

10. Crear el ID del cliente y el secreto

2. Configurar Claude para escritorio

1. Instalar Claude para escritorio

2. Abra el archivo de configuración de Claude:

   • MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Ventanas: %APPDATA%\Claude\claude_desktop_config.json

3. Agregue la configuración del servidor MCP de Google Tasks:

Reemplace la ruta y las credenciales con sus propios valores.

3. Construya y ejecute el servidor

1. Instalar dependencias:

2. Construir el servidor:

3. Reiniciar Claude para escritorio

Flujo de autenticación

Cuando utilice por primera vez el servidor MCP de Google Tasks:

1. Utilice la herramienta authenticate para obtener una URL de autorización

2. Visita la URL en tu navegador e inicia sesión con tu cuenta de Google

3. Después de autorizar, recibirás un código en la página del navegador.

4. Utilice la herramienta set-auth-code con este código para completar la autenticación

5. Ahora puedes usar todas las demás herramientas para interactuar con Google Tasks

Tenga en cuenta que su autenticación se basa en la sesión y se perderá al reiniciar el servidor. Deberá volver a autenticarse cada vez.

Requisitos

• Node.js 14+

• Claude para escritorio (última versión)

• Proyecto de Google Cloud con la API de tareas habilitada

Captura de pantalla

Licencia

Este proyecto es solo para fines demostrativos. Úselo bajo su propio riesgo.