A
securityA
licenseA
qualityProvides tools for interacting with Gmail and Calendar APIs. This server enables you to manage your emails and calendar events programmatically through the MCP interface.
Last updated -
8
25
JavaScript
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
- Crear un nuevo proyecto de Google Cloud
- Habilitar 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/modify - Cree 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.
- La ruta absoluta a este archivo se pasará como parámetro
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 |
|---|---|
--creds-file-path | /[your-home-folder]/.google/client_creds.json |
--token-path | /[your-home-folder]/.google/app_tokens.json |
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 .
Se deben configurar los siguientes parámetros
| Parámetro | Ejemplo |
|---|---|
--directory | Ruta absoluta al directorio gmail que contiene el servidor |
--creds-file-path | Ruta absoluta al archivo de credenciales creado en la configuración de la API de Gmail. |
--token-path | 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.
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Servidor MCP que se integra con Gmail para permitir el envío, la lectura y la gestión de correos electrónicos a través de herramientas como send-email, trash-email, get-unread-emails y read-email.
Related Resources
Related MCP Servers
- -securityAlicense-qualityIntegrates with Gmail to enable sending, reading, drafting, and managing emails via the Model Context Protocol (MCP), allowing users to interact with email tasks through automated client prompts.Last updated -2PythonGPL 3.0
- -securityAlicense-qualityAn MCP server that enables Gmail integration, allowing users to manage emails (send, receive, read, trash, mark as read) directly through MCP clients like Claude Desktop.Last updated -PythonMIT License
- -securityFlicense-qualityAn MCP server that enables programmatic interaction with Google Groups Migration API for importing messaging data into Google Groups, allowing users to migrate email messages from external systems.Last updated -Python