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.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Permite interactuar con Gmail a través de la API para leer, enviar y administrar correos electrónicos. Admite múltiples cuentas de Gmail con monitorización en tiempo real y funciones avanzadas para la búsqueda de correos electrónicos y la gestión de archivos adjuntos.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Gmail MCP Server
jmonsellier
-
security
A
license
-
quality
Integrates 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 -
Python
GPL 3.0
Systemprompt MCP Gmail Server
Ejb503
-
security
F
license
-
quality
Enables users to manage Gmail accounts using AI agent-assisted operations via an MCP protocol, supporting email search, reading, deletion, and sending with a voice-powered interface.
Last updated -
2
5
TypeScript
MCP Email Server
ai-zerolab
-
security
A
license
-
quality
Provides IMAP and SMTP capabilities, enabling developers to manage email services with seamless integration and automated workflows.
Last updated -
38
Python
BSD 3-Clause
Gmail MCP Server
cablate
-
security
A
license
-
quality
Provides comprehensive Gmail integration with LLM processing capabilities, allowing users to read, search, filter emails and handle attachments through the Model Context Protocol.
Last updated -
3
1
TypeScript
MIT License

View all related MCP servers

Gmail MCP Server