Gmail MCP

Una implementación del Protocolo de Contexto de Modelo (MCP) para la API de Gmail , que proporciona una interfaz estandarizada para la gestión, el envío y la recuperación de correo electrónico.

Características

• Cobertura completa de la API de Gmail, incluidos mensajes, hilos, etiquetas, borradores y configuraciones
• Soporte para enviar, redactar y gestionar correos electrónicos
• Gestión de etiquetas con colores personalizables y configuraciones de visibilidad
• Operaciones de hilo para la gestión de conversaciones
• Administración de configuraciones, incluyendo respuesta automática, IMAP/POP y configuración de idioma
• Seguimiento del historial de cambios en el buzón
• Autenticación OAuth2 segura con sus credenciales de Google Cloud

Instalación

⚠️ NOTA: Debido a la gran cantidad de puntos finales disponibles en este servidor, se recomienda que instale y configure Heimdall para limitar la cantidad de puntos finales expuestos a sus aplicaciones cliente.

Para utilizar este MCP, deberá configurar la autenticación con Gmail:

1. Vaya a la consola de Google Cloud
2. Crea un nuevo proyecto o selecciona uno existente
3. Habilite la API de Gmail para su proyecto
4. Vaya a Credenciales y cree un ID de cliente OAuth 2.0
   • Elija "Aplicación de escritorio" como tipo de aplicación ( Advertencia : si no elige este tipo, el servidor no podrá analizar las claves de su archivo JSON)
   • Descargar el archivo JSON de credenciales del cliente
5. Guarde el archivo de credenciales descargado en ~/.gmail-mcp/gcp-oauth.keys.json

NPX (Recomendado)

Agregue lo siguiente a su cliente MCP config.json ( ~/.heimdall/config.json si usa Heimdall):

Descarga manual

1. Descargar el repositorio:

2. Instalar paquetes y compilar (dentro del repositorio clonado):

3. Agregue lo siguiente a su cliente MCP config.json ( ~/.heimdall/config.json si usa Heimdall):

Herrería

Para instalar Claude Desktop automáticamente a través de Smithery :

Autenticación

Automatizado (recomendado)

Este MCP proporciona un flujo de autenticación automatizado:

1. Primero, obtenga las credenciales OAuth y descargue el archivo JSON.
2. Cambie el nombre del archivo JSON a gcp-oauth.keys.json y cópielo en $HOME/.gmail-mcp/ o donde lo haya configurado en MCP_CONFIG_DIR .
3. Ejecute el comando de autenticación:

4. Se abrirá automáticamente una ventana del navegador en la pantalla de consentimiento de Google OAuth.
5. Después de conceder el acceso, puede cerrar la ventana del navegador.
6. Los tokens se guardarán automáticamente en $HOME/.gmail-mcp/credentials.json

El MCP automáticamente:

• Administrar la actualización del token
• Guardar credenciales en el disco
• Manejar la devolución de llamada OAuth
• Abra la URL de autenticación en su navegador predeterminado

Nota: De forma predeterminada, este servidor usa el puerto 3000 para recibir la respuesta de OAuth. Puede configurar AUTH_SERVER_PORT con otro valor si está ejecutando otro servicio en el 3000 .

Puede personalizar la ubicación de la configuración configurando MCP_CONFIG_DIR antes de ejecutar el comando (opcional):

Manual (sugerido para el uso de Docker)

Si lo desea, también puede proporcionar credenciales directamente a través de las variables de entorno:

Puntos finales compatibles

Gestión de usuarios

• get_profile : obtiene el perfil de Gmail del usuario actual
• stop_mail_watch : Dejar de recibir notificaciones push
• watch_mailbox : Configurar notificaciones push para cambios en el buzón

Gestión de mensajes

Administrar mensajes

• list_messages : Lista de mensajes con filtrado opcional
• get_message : Obtener un mensaje específico
• get_attachment : Obtener un archivo adjunto del mensaje
• modify_message : Modificar las etiquetas de los mensajes
• send_message : envía un mensaje de correo electrónico a los destinatarios especificados
• delete_message : Eliminar permanentemente un mensaje
• trash_message : Mover el mensaje a la papelera
• untrash_message : Eliminar mensaje de la papelera
• batch_modify_messages : Modificar varios mensajes
• batch_delete_messages : Eliminar varios mensajes

Gestión de etiquetas

• list_labels : Lista todas las etiquetas
• get_label : Obtener una etiqueta específica
• create_label : Crea una nueva etiqueta
• update_label : Actualizar una etiqueta
• patch_label : Actualización parcial de una etiqueta
• delete_label : Eliminar una etiqueta

Gestión de subprocesos

• list_threads : Lista de hilos de correo electrónico
• get_thread : Obtener un hilo específico
• modify_thread : Modificar las etiquetas de los hilos
• trash_thread : Mover el hilo a la papelera
• untrash_thread : Quitar el hilo de la papelera
• delete_thread : Eliminar un hilo

Gestión de borradores

• list_drafts : Lista los borradores en el buzón del usuario
• get_draft : Obtener un borrador específico por ID
• create_draft : Crea un borrador de correo electrónico en Gmail
• update_draft : Reemplazar el contenido de un borrador
• delete_draft : Eliminar un borrador
• send_draft : Envía un borrador existente

Administración de configuraciones

Reenvío automático

• get_auto_forwarding : Obtener la configuración de reenvío automático
• update_auto_forwarding : Actualizar la configuración de reenvío automático

Configuración de IMAP

• get_imap : Obtener la configuración de IMAP
• update_imap : Actualizar la configuración de IMAP

Configuración POP

• get_pop : Obtener la configuración POP
• update_pop : Actualizar la configuración POP

Respondedor de vacaciones

• get_vacation : Obtener la configuración de respuesta en caso de vacaciones
• update_vacation : Actualizar la respuesta de vacaciones

Configuración de idioma

• get_language : Obtener la configuración del idioma
• update_language : Actualizar la configuración del idioma

Delegados

• list_delegates : Lista de delegados de la cuenta
• get_delegate : Obtener un delegado específico
• add_delegate : Agregar un delegado
• remove_delegate : Eliminar un delegado

Filtros

• list_filters : Lista de filtros de correo electrónico
• get_filter : Obtener un filtro específico
• create_filter : Crea un nuevo filtro
• delete_filter : Eliminar un filtro

Direcciones de reenvío

• list_forwarding_addresses : Lista de direcciones de reenvío
• get_forwarding_address : Obtener una dirección de reenvío específica
• create_forwarding_address : Crea una dirección de reenvío
• delete_forwarding_address : Eliminar una dirección de reenvío

Configuración de envío como

• list_send_as : Lista de alias de envío
• get_send_as : Obtener un alias de envío específico
• create_send_as : Crea un alias de envío como
• update_send_as : Actualizar un alias de envío como
• patch_send_as : Actualización parcial de un alias de envío como
• verify_send_as : Enviar correo electrónico de verificación
• delete_send_as : Eliminar un alias de envío como

Configuración S/MIME

• list_smime_info : Lista de configuraciones S/MIME
• get_smime_info : Obtener una configuración S/MIME específica
• insert_smime_info : Cargar una nueva configuración S/MIME
• set_default_smime_info : Establecer la configuración S/MIME predeterminada
• delete_smime_info : Eliminar una configuración S/MIME

Contribuyendo

Se agradecen y animamos las contribuciones. Para cualquier pregunta, comentario o inquietud, contacte con austin@shinzolabs.com .