Google MCP
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
Prerrequisitos:
Instalar Bun:
brew install oven-sh/bun/bun # macOS/Linux with HomebrewConfigurar 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.).
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>"
}
}
}
}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.
Related MCP server: Google Search MCP Server
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.tsGracias 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!
Available Tools
32 toolsgoogle_calendar_create_eventC
Create a new event in Google Calendar
Inputs: end (required), start (required), summary (required), attendees, +5 more.
google_calendar_delete_eventC
Delete an event from Google Calendar
Inputs: eventId (required), calendarId.
google_calendar_find_free_timeC
Find available time slots between events
Inputs: duration (required), endDate (required), startDate (required), calendarIds.
google_calendar_get_eventC
Get detailed information about a specific event
Inputs: eventId (required), calendarId.
google_calendar_get_eventsC
Retrieve upcoming events from Google Calendar
Inputs: calendarId, limit, q, showDeleted, +2 more.
google_calendar_list_calendarsB
List all available calendars
Inputs: no named parameters.
google_calendar_set_defaultC
Set the default calendar ID for operations
Inputs: calendarId (required).
google_calendar_update_eventC
Update an existing event in Google Calendar
Inputs: eventId (required), attendees, calendarId, colorId, +6 more.
google_drive_create_fileC
Create a new file in Google Drive
Inputs: content (required), name (required), folderId, mimeType.
google_drive_delete_fileC
Delete a file from Google Drive
Inputs: fileId (required), permanently.
google_drive_get_file_contentC
Get the content of a file from Google Drive
Inputs: fileId (required).
google_drive_list_filesC
List files from Google Drive
Inputs: fields, orderBy, pageSize, query.
google_drive_update_fileC
Update the content of an existing file in Google Drive
Inputs: content (required), fileId (required), mimeType.
google_gmail_delete_emailC
Delete or trash an email
Inputs: messageId (required), permanently.
google_gmail_draft_emailC
Create a draft email
Inputs: body (required), subject (required), to (required), bcc, +2 more.
google_gmail_get_emailB
Get detailed information about a specific email
Inputs: messageId (required), format.
google_gmail_get_email_by_indexB
Get email by its index from the most recent search results
Inputs: index (required), format.
google_gmail_list_emailsC
List emails from a specific label or folder
Inputs: labelIds, maxResults, query.
google_gmail_list_labelsB
List all available Gmail labels
Inputs: no named parameters.
google_gmail_modify_labelsC
Add or remove labels from an email
Inputs: messageId (required), addLabelIds, removeLabelIds.
google_gmail_send_emailC
Send a new email
Inputs: body (required), subject (required), to (required), bcc, +2 more.
google_tasks_complete_taskC
Mark a task as completed
Inputs: taskId (required), taskListId.
google_tasks_create_taskC
Create a new task
Inputs: title (required), due, notes, taskListId.
google_tasks_create_tasklistC
Create a new task list
Inputs: title (required).
google_tasks_delete_taskC
Delete a task
Inputs: taskId (required), taskListId.
google_tasks_delete_tasklistC
Delete a task list
Inputs: taskListId (required).
google_tasks_get_taskC
Get details about a specific task
Inputs: taskId (required), taskListId.
google_tasks_list_tasklistsB
List all available task lists
Inputs: no named parameters.
google_tasks_list_tasksC
List tasks from a task list
Inputs: showCompleted, taskListId.
google_tasks_set_default_listC
Set the default task list ID for operations
Inputs: taskListId (required).
google_tasks_update_taskC
Update an existing task
Inputs: taskId (required), due, notes, status, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 32 tools
Every tool has a clearly distinct purpose with no ambiguity, as each is scoped to a specific Google service (Calendar, Drive, Gmail, Tasks) and a specific action on a resource (e.g., create, delete, list). Overlap is minimal, such as 'google_calendar_get_event' and 'google_calendar_get_events' being clearly differentiated by singular vs. plural.
Tool names follow a highly consistent verb_noun pattern throughout, with a clear structure: 'google_service_action_resource' (e.g., 'google_calendar_create_event'). All tools use snake_case uniformly, and verbs are predictable (create, delete, get, list, update, etc.), making the set easy to navigate.
With 32 tools, the count is borderline high for a single server, as it covers multiple Google services (Calendar, Drive, Gmail, Tasks). While each service is well-scoped individually, the overall set feels heavy and might be better split into separate servers, but it's not extreme (e.g., not 50+ tools).
The tool surface provides complete CRUD/lifecycle coverage for each Google service domain, with no obvious gaps. For example, Calendar has create, get, list, update, delete, plus utilities like find_free_time; Gmail includes send, draft, get, list, delete, and label management; ensuring agents can handle full workflows without dead ends.
Related MCP Connectors
MCP server connecting AI agents to 100+ apps (Gmail, Slack, Notion, GitHub) via one-click OAuth.
Hosted Google Calendar MCP server for AI agents. No self-hosting or Google Cloud setup.
Read and edit GA4, Search Console and Google Tag Manager from any MCP client. 29 tools.
The OpenRouter for tools. One MCP connection gives any AI agent 254 hosted tools, pay per call.
Related MCP Servers
- AlicenseAqualityBmaintenanceThis server enables users to perform Google News searches with automatic categorization and multi-language support via SerpAPI integration.4191 npm131MIT
- FlicenseNot gradedqualityCmaintenanceAn MCP (Model Context Protocol) server that provides Google search capabilities and webpage content analysis tools. This server enables AI models to perform Google searches and analyze webpage content programmatically.262-
- FlicenseNot gradedqualityDmaintenanceA locally-hosted MCP server that integrates Gmail, Google Calendar, and Google Drive to provide AI-powered management of emails, events, and files. It enables tool-based interactions like sending emails, creating calendar events, and searching Drive files through clients like Cursor and Claude Desktop.-
- AlicenseAqualityCmaintenanceMCP server for Google APIs — Gmail and Calendar tools for LLM agents.62MIT