Servidor MCP de Gmail

Un servidor de integración de Gmail potente y flexible, desarrollado con el framework MCP (Protocolo de Control de Mensajes). Este servidor proporciona una interfaz robusta para interactuar con las API de Gmail, ofreciendo funcionalidades para leer, enviar y gestionar correos electrónicos programáticamente.

Características

Leer correos electrónicos de varias cuentas de Gmail
Enviar correos electrónicos con archivos adjuntos
Buscar correos electrónicos con opciones de consulta avanzadas
Descargar archivos adjuntos de correo electrónico
Gestionar conversaciones y hilos de correo electrónico
Monitoreo de correo electrónico en tiempo real
Compatibilidad con múltiples cuentas de Gmail

Prerrequisitos

Antes de ejecutar el servidor MCP de Gmail, asegúrese de tener lo siguiente:

Python 3.12 o superior
Proyecto de Google Cloud con la API de Gmail habilitada
Credenciales de ID de cliente de OAuth 2.0
Paquetes de Python necesarios (especificados en pyproject.toml)

Instalación

Instalación mediante herrería

Para instalar Gmail Integration Server para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @Quantum-369/Gmail-mcp-server --client claude

Clonar el repositorio:

git clone <your-repository-url>
cd gmail-mcp-server

Crear y activar un entorno virtual:

python -m venv venv
# On Windows
venv\Scripts\activate
# On Unix/MacOS
source venv/bin/activate

Instalar dependencias:

pip install .

Configurar el proyecto de Google Cloud

Vaya a la consola de Google Cloud
Crea un nuevo proyecto o selecciona uno existente
Habilite la API de Gmail para su proyecto
Crear credenciales OAuth 2.0:
- Vaya a "API y servicios" > "Credenciales".
- Haga clic en "Crear credenciales" > "ID de cliente OAuth".
- Seleccione "Aplicación de escritorio" como tipo de aplicación
- Descargar el archivo de configuración del cliente
Cambie el nombre del archivo descargado a client_secret.json y colóquelo en el directorio raíz del proyecto

Configuración

Configurar identificadores de correo electrónico en gmail_token_creator.py :

email_identifier = 'your.email@gmail.com'  # Change this for each account

Ejecute el creador de tokens para autenticar sus cuentas de Gmail:

python gmail_token_creator.py

Repita el proceso para cada cuenta de Gmail que desee integrar

Estructura del servidor

gmail_server.py : Implementación del servidor MCP principal
gmail_api.py : Funciones de interacción de la API de Gmail
google_apis.py : utilidades de autenticación de la API de Google
Archivos de apoyo:
- read_emails.py : funcionalidad de lectura de correo electrónico
- search_emails.py : Función de búsqueda de correo electrónico
- send_emails.py : funcionalidad de envío de correo electrónico

Uso

Iniciando el servidor

python gmail_server.py

Herramientas disponibles

Enviar correo electrónico:

await send_gmail(
    email_identifier="your.email@gmail.com",
    to="recipient@example.com",
    subject="Test Subject",
    body="Email body content",
    attachment_paths=["path/to/attachment"]
)

Buscar correos electrónicos:

await search_email_tool(
    email_identifier="your.email@gmail.com",
    query="from:someone@example.com",
    max_results=30,
    include_conversations=True
)

Leer los últimos correos electrónicos:

await read_latest_emails(
    email_identifier="your.email@gmail.com",
    max_results=5,
    download_attachments=False
)

Descargar archivos adjuntos:

await download_email_attachments(
    email_identifier="your.email@gmail.com",
    msg_id="message_id",
    download_all_in_thread=False
)

Consideraciones de seguridad

Almacene client_secret.json de forma segura y nunca lo envíe al control de versiones
Mantenga los archivos de token seguros y agréguelos a .gitignore
Utilice variables de entorno para información confidencial
Rotar periódicamente las credenciales de OAuth
Supervisar el uso de la API y establecer cuotas adecuadas

Manejo de errores

El servidor incluye gestión y registro de errores integrales:

Los registros se escriben en gmail_mcp.log
Tanto el registro de archivos como el de consola están habilitados
Mensajes de error detallados para depuración

Contribuyendo

Bifurcar el repositorio
Crear una rama de características
Confirme sus cambios
Empujar hacia la rama
Crear una solicitud de extracción

Licencia

Licencia Apache 2.0

Apoyo

Para problemas y solicitudes de funciones, utilice el rastreador de problemas de GitHub.

Gmail MCP Server

Integrations