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 mediante credenciales de Google Cloud

Prerrequisitos

Para ejecutar este servidor MCP, primero debe configurar un cliente de API de Google para su organización, en el que cada usuario ejecutará un script para recuperar su propio token de actualización de OAuth.

Configuración del cliente de API de Google (una vez por organización)

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. Seleccione "Aplicación de escritorio" como tipo de cliente.

5. Descargue y guarde las claves OAuth JSON como ~/.gmail-mcp/gcp-oauth.keys.json .

6. (Opcional) Para la instalación en servidor remoto (por ejemplo, utilizando Smithery CLI), anote CLIENT_ID y CLIENT_SECRET de este archivo.

OAuth de cliente (una vez por usuario)

1. Haga que el usuario copie ~/.gmail-mcp/gcp-oauth.keys.json a su computadora en la misma ruta.

2. Ejecute npx @shinzolabs/gmail-mcp auth .

3. Se abrirá una ventana del navegador donde el usuario podrá seleccionar un perfil, revisar los alcances solicitados y aprobarlos.

4. (Opcional) Para la instalación en un servidor remoto, anote la ruta del archivo mencionada en el mensaje de éxito ( ~/.gmail-mcp/credentials.json por defecto). El REFRESH_TOKEN del usuario se encontrará aquí.

Configuración del cliente

Hay varias opciones para configurar el cliente MCP con el servidor. Para la configuración de un servidor alojado/remoto, utilice la CLI de Smithery con una clave API de Smithery . Para la instalación local, utilice npx o compile desde el código fuente. Cada una de estas opciones se explica a continuación.

Servidor remoto de Smithery (recomendado)

Para agregar un servidor remoto a su cliente MCP config.json , ejecute el siguiente comando desde Smithery CLI :

Ingrese su CLIENT_ID , CLIENT_SECRET y REFRESH_TOKEN cuando se le solicite.

SDK de herrería

Si está desarrollando su propia aplicación de agente, puede utilizar el código repetitivo aquí .

Instalación local de NPX

Para instalar el servidor localmente con npx , agregue lo siguiente a su cliente MCP config.json :

Construir desde la fuente

1. Descargar el repositorio:

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

3. Agregue lo siguiente a su cliente MCP config.json :

Variables de configuración

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! Consulte CONTRIBUTING.md para obtener información sobre problemas, contribuciones e información de contacto.