A
securityA
licenseA
qualityModel Context Protocol server for Gmail integration. This allows Claude Desktop (or any MCP client) to interact with your Gmail account through Google Apps Script.
Last updated -
26
12
MIT License
Servidor de Gmail para el Protocolo de Contexto de Modelo (MCP)
Este servidor MCP se integra con Gmail para permitir enviar, eliminar, leer, redactar y responder correos electrónicos.
Nota: Este servidor permite que un cliente MCP lea, elimine y envíe correos electrónicos. Sin embargo, el cliente avisa al usuario antes de realizar dichas actividades.
https://github.com/user-attachments/assets/5794cd16-00d2-45a2-884a-8ba0c3a90c90
Componentes
Herramientas
enviar correo electrónico
Envía un correo electrónico al destinatario de la dirección de correo electrónico
Aporte:
recipient_id(cadena): Dirección de correo electrónico del destinatariosubject(cadena): asunto del correo electrónicomessage(cadena): contenido del correo electrónico
Devuelve el estado y el message_id
correo electrónico basura
Mueve el correo electrónico a la papelera
Aporte:
email_id(cadena): ID de correo electrónico generado automáticamente
Devuelve un mensaje de éxito
marcar correo electrónico como leído
Marca el correo electrónico como leído
Aporte:
email_id(cadena): ID de correo electrónico generado automáticamente
Devuelve un mensaje de éxito
obtener correos electrónicos no leídos
Recupera correos electrónicos no leídos
Devuelve una lista de correos electrónicos, incluido el ID del correo electrónico.
leer correo electrónico
Recupera el contenido del correo electrónico proporcionado
Aporte:
email_id(cadena): ID de correo electrónico generado automáticamente
Devuelve el diccionario de metadatos de correo electrónico y marca el correo electrónico como leído
correo electrónico abierto
Abrir el correo electrónico en el navegador
Aporte:
email_id(cadena): ID de correo electrónico generado automáticamente
Devuelve un mensaje de éxito y abre el correo electrónico indicado en el navegador predeterminado.
Configuración
Configuración de la API de Gmail
Configurar una pantalla de consentimiento de OAuth
Seleccione "externo". Sin embargo, no publicaremos la aplicación.
Añade tu dirección de correo electrónico personal como "Usuario de prueba".
Agregar ámbito OAuth
https://www.googleapis.com/auth/gmail/modifyCree un ID de cliente OAuth para el tipo de aplicación "Aplicación de escritorio"
Descargue el archivo JSON de las claves OAuth de su cliente
Cambie el nombre del archivo de clave y guárdelo en una ubicación segura de su equipo local. Anote la ubicación.
La ruta absoluta a este archivo se pasará como parámetro
--creds-file-pathcuando se inicie el servidor.
Autenticación
Al iniciar el servidor, se iniciará un flujo de autenticación en el navegador del sistema. Las credenciales del token se guardarán (y se recuperarán posteriormente) en la ruta absoluta del archivo indicada en el parámetro --token-path .
Por ejemplo, puede utilizar un directorio de puntos en su carpeta de inicio, reemplazando [your-home-folder] .:
Parámetro | Ejemplo |
|
|
|
|
Uso con la aplicación de escritorio
Se recomienda el uso de rayos UV .
Para integrar este servidor con Claude Desktop como cliente MCP, agregue lo siguiente a la configuración del servidor de su aplicación. De forma predeterminada, se almacena como ~/Library/Application\ Support/Claude/claude_desktop_config.json .
{
"mcpServers": {
"gdrive": {
"command": "uv",
"args": [
"--directory",
"[absolute-path-to-git-repo]",
"run",
"gmail",
"--creds-file-path",
"[absolute-path-to-credentials-file]",
"--token-path",
"[absolute-path-to-access-tokens-file]"
]
}
}
}
Se deben configurar los siguientes parámetros
Parámetro | Ejemplo |
| Ruta absoluta al directorio
que contiene el servidor |
| Ruta absoluta al archivo de credenciales creado en la configuración de la API de Gmail. |
| Ruta absoluta para almacenar y recuperar tokens de acceso y actualización para la aplicación. |
Solución de problemas con MCP Inspector
Para probar el servidor, use MCP Inspector . Desde el repositorio de Git, ejecute lo siguiente y modifique los argumentos de los parámetros según corresponda.
npx @modelcontextprotocol/inspector uv run [absolute-path-to-git-repo]/src/gmail/server.py --creds-file-path [absolute-path-to-credentials-file] --token-path [absolute-path-to-access-tokens-file]
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
Se integra con Gmail para permitir el envío, la lectura, la redacción y la gestión de correos electrónicos a través del Protocolo de contexto de modelo (MCP), lo que permite a los usuarios interactuar con tareas de correo electrónico a través de indicaciones automatizadas del cliente.
Related Resources
Related MCP Servers
- -securityAlicense-qualityEnables interaction with Gmail and Google Calendar using the MCP protocol, supporting multiple Google accounts, email management, and calendar operations through natural language.Last updated -13MIT License
- -securityAlicense-qualityProvides comprehensive Gmail integration with LLM processing capabilities, allowing users to read, search, filter emails and handle attachments through the Model Context Protocol.Last updated -81MIT License
- -securityAlicense-qualityMCP server that integrates with Gmail to enable sending, reading, and managing emails through tools like send-email, trash-email, get-unread-emails, and read-email.Last updated -60GPL 3.0