Google MCP

by vakharwalad23
Verified

Herramientas MCP de Google

Esta es una colección de herramientas nativas de Google (por ejemplo, Gmail, Calendario) para el protocolo MCP , diseñadas para integrarse perfectamente con clientes de IA como Claude o Cursor.

{ "mcpServers": { "google-mcp": { "command": "bunx", "args": ["--no-cache", "google-mcp@latest"], "env": { // Either can be used, but not both // Use OAuth "GOOGLE_OAUTH_CLIENT_ID": "<YOUR_CLIENT_ID>", "GOOGLE_OAUTH_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>", "GOOGLE_OAUTH_TOKEN_PATH": "<PATH_TO_STORE_TOKENS> CAN_BE_ANYWHERE_ON_YOUR_SYSTEM", // Use Service Account "GOOGLE_CLIENT_EMAIL": "<YOUR_SERVICE_ACCOUNT_EMAIL>", "GOOGLE_PRIVATE_KEY": "<YOUR_SERVICE_ACCOUNT_PRIVATE_KEY>", "GMAIL_USER_TO_IMPERSONATE": "<USER_TO_IMPERSONATE>" } } } }

Características

  • Gmail:
    • Envía correos electrónicos con múltiples destinatarios (para, cc, cco) y archivos adjuntos.
    • Enumere correos electrónicos con consultas personalizadas, etiquetas y límites de resultados.
    • Leer correos electrónicos específicos por ID.
    • Administrar etiquetas (agregar, eliminar, listar).
    • Redactar y eliminar correos electrónicos.
  • Calendario:
    • Enumere calendarios y establezca un calendario predeterminado.
    • Crea eventos con detalles (resumen, hora de inicio/fin, asistentes, etc.).
    • Enumere los próximos eventos con filtros personalizables.
    • Actualizar o eliminar eventos existentes.
    • Encuentra franjas horarias libres para programar.
  • Conducir:
    • Filtrar con consultas de búsqueda
    • Ordenar por fecha de modificación u otros criterios
    • Personalizar el recuento de visualización
    • Ver metadatos detallados del archivo
    • Leer el contenido del archivo (texto, documentos, hojas de cálculo)
    • Crear nuevos archivos con contenido específico
    • Actualizar archivos existentes
    • Eliminar archivos (papelera o permanentes)
    • Compartir archivos con permisos específicos
  • Tareas:
    • Ver todas las listas de tareas
    • Crear nuevas listas de tareas
    • Eliminar listas de tareas existentes
    • Establecer lista de tareas predeterminada
    • Listar tareas con filtros
    • Ver detalles de la tarea
    • Crea tareas con título, notas y fechas de vencimiento.
    • Actualizar las propiedades de la tarea
    • Marcar tareas como completadas
    • Eliminar tareas
  • Planes TODO:
    • Contactos de Google: busque y administre contactos.
    • Y muchos más...

Puede encadenar comandos para flujos de trabajo, por ejemplo:

"Enumera mis correos electrónicos no leídos, redacta una respuesta al último y programa una reunión de seguimiento mañana a las 2 p. m."

Instalación manual

  1. Prerrequisitos:
    • Instalar Bun:
    brew install oven-sh/bun/bun # macOS/Linux with Homebrew
  2. Configurar OAuth:
    • Crea un proyecto de Google Cloud en Google Cloud Console .
    • Configurar las credenciales de OAuth 2.0 (ID de cliente, secreto de cliente).
    • Seleccione el tipo de aplicación de escritorio.
    • Si utiliza el modo de prueba, agregue su correo electrónico a la lista de usuarios de prueba.
    • Asegúrese de habilitar el acceso API para los servicios deseados (Gmail, Calendario, Drive, etc.).
  3. Configure su cliente: edite su claude_desktop_config.json (o archivo de configuración equivalente para su cliente):
{ "mcpServers": { "google-mcp": { "command": "bunx", "args": ["--no-cache", "google-mcp@latest"], "env": { // Either can be used, but not both // Use OAuth "GOOGLE_OAUTH_CLIENT_ID": "<YOUR_CLIENT_ID>", "GOOGLE_OAUTH_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>", "GOOGLE_OAUTH_TOKEN_PATH": "<PATH_TO_STORE_TOKENS>", // Use Service Account "GOOGLE_CLIENT_EMAIL": "<YOUR_SERVICE_ACCOUNT_EMAIL>", "GOOGLE_PRIVATE_KEY": "<YOUR_SERVICE_ACCOUNT_PRIVATE_KEY>", "GMAIL_USER_TO_IMPERSONATE": "<USER_TO_IMPERSONATE>" } } } }
  1. Autenticar:
    • La primera vez que ejecute el servidor, se abrirá un navegador para la autenticación OAuth. Siga las instrucciones para conceder acceso y los tokens se guardarán en GOOGLE_OAUTH_TOKEN_PATH.

Uso

Ahora, pídale a Claude que utilice la herramienta google-mcp .

Send an email to jane.doe@example.com with the subject "Meeting Notes" and body "Here are the notes from today."
List my upcoming calendar events for the next 3 days.
Create a calendar event titled "Team Sync" tomorrow at 10 AM for 1 hour.

Desarrollo local

git clone https://github.com/vakharwalad23/google-mcp.git cd google-mcp bun install bun run index.ts

Gracias por usar las herramientas de Google MCP. Si tienes alguna pregunta o sugerencia, no dudes en abrir un problema o contribuir al proyecto.

¡Juega con las herramientas y disfruta!

-
security - not tested
-
license - not tested
-
quality - not tested

Esta es una colección de herramientas nativas de Google (por ejemplo, Gmail, Calendario) para el protocolo MCP, diseñadas para integrarse perfectamente con clientes de IA como Claude o Cursor.

  1. Features
    1. Manual Installation
  2. Usage
    1. Local Development
      ID: opwf6bop3j