Gmail MCP

Gmail MCP - Instalación Automática y Segura

Acceso de asistentes de IA a Gmail mediante el Model Context Protocol (MCP)

Requisito esencial:Debes tener instaladoClaude Desktoppara poder utilizar este servidor MCP.

https://github.com/user-attachments/assets/e49b2d76-bcef-4d44-9222-6818f0f57998
- Primero:

- Ve aGoogle Cloud Console
- Crea un proyecto y habilita la API de Gmail
- Agregahttp://localhost:8080/a lasURIs de redireccionamiento autorizados
- Descarga el archivoclient_secret_...jsony déjalo en tu carpeta Descargas (no te preocupes por el nombre ni la ubicación final)
- El instalador detectará y moverá el archivo automáticamente a la carpeta correcta y con el nombre adecuado

[!IMPORTANT] Solo necesitas descargar el archivo de credenciales desde Google Cloud despues configurar lasURIs de redireccionamiento autorizadasy dejarlo en Descargas. ¡No te preocupes por el nombre ni la ubicación final, el instalador se encarga de todo!
- Clona este repositorio desde tuterminal:

git clone https://github.com/FranciscoYuster/claude-client-gmail-mcp cd claude-client-gmail-mcp

- Sigue los mismos pasos de Google Cloud indicados arriba para obtener tu archivo de credenciales y dejarlo en Descargas.
- Clona este repositorio desde tu terminal:

git clone https://github.com/FranciscoYuster/gmail-client-mcp-server cd gmail-client-mcp-server

[!IMPORTANT] Si usasWindows, ejecuta:python setup.pySi usasmacOS o Linux, ejecuta:python3 setupUnix.pyAmbos scripts ejecutan la instalación, pero cada uno está adaptado a su sistema operativo.

[!WARNING]Nunca subas ni compartas tu archivo de credenciales.Si lo expones por error, elimínalo y genera uno nuevo en Google Cloud Console. El script nunca sube ni distribuye tus datos sensibles.

- Python 3.11 o superior
- git
- Cuenta de Gmail
- Claude Dekstop

[!TIP] El instalador te guiará para instalar cualquier requisito que falte.
- Clona este repositorio:

git clone https://github.com/FranciscoYuster/claude-client-gmail-mcp cd claude-client-gmail-mcp

- Crea un directorio llamadocredentialsen la raíz del proyecto
- Crea un proyecto enGoogle Cloud Console
- Habilita la API de Gmail
- Crea credenciales OAuth
- Agrega la siguiente URI a lasURIs de redirección autorizadas:

http://localhost:8080/

[!CAUTION] Asegúrate de que la ruta y el nombre del archivo de credenciales sean correctos para evitar errores de autenticación.
-

Agrega el servidor MCP a tu configuración JSON. Por favor, consulta la documentación oficial de tu cliente MCP para instrucciones específicas. Asegúrate de ajustar la ruta según tu entorno:

{ "mcpServers": { "gmail-mcp": { "command": "uv", "args": [ "--directory", "/path/to/your/gmail-mcp/src", "run", "main.py" ] } } }

El servidor incluye una serie de herramientas para operar y automatizar Gmail desde asistentes de IA. Estas herramientas permiten enviar, leer, buscar, gestionar correos y etiquetas. A continuación se listan las principales funciones disponibles:

- Enviar correos(con adjuntos, CC, BCC, respuesta a hilos)
- Crear borradoresde correos (con adjuntos)
- Descargar adjuntosde un mensaje
- Leer correospor ID (texto y HTML, con fragmentación para mensajes grandes)
- Buscar correoscon filtros avanzados (consulta, etiquetas, remitente, adjuntos, paginación)
- Obtener hiloscompletos de conversación
- Marcar como leído/no leído/importante/no importante

- Añadir o eliminar etiquetasde un correo
- Crear nuevas etiquetas
- Eliminar etiquetas por nombre
- Listar todas las etiquetas
- Obtener o crear etiquetas por nombre
- Actualizar configuración de etiquetas(nombre, visibilidad, color)
- Buscar etiquetas por nombre

Estas herramientas permiten una gestión avanzada y automatizada del correo electrónico y las etiquetas de Gmail, facilitando la integración con asistentes de IA y flujos de trabajo

Send emails via SMTP. Requires SMTP server credentials to be configured through environment variables.

Query live Gmail data using LLMs via CData's read-only MCP server.

Tools for common Gmail operations, such as sending emails.

Provides comprehensive integration with Gmail for reading, searching, and sending emails.

An MCP server for Gmail, allowing AI assistants to manage emails through natural language.

Search and delete emails in your Gmail account.

Enables AI assistants to manage Gmail through natural language interactions.

An MCP server for integrating Gmail with auto-authentication support.

A standardized interface for managing, sending, and retrieving emails through the Gmail API.

Manage your Gmail account, including sending, reading, and organizing emails.