gmail-mcp
Servidor MCP autoalojado para Gmail basado en la API oficial de Google. Proporciona acceso seguro a lectura y redacción de borradores sin enviar datos a terceros, con servidor OAuth 2.1 integrado para clientes alojados.
Ficha actualizada 28 sept 2026, 7:17 · upstream 28 sept 2026, 3:35 · release sin release detectada
Qué es gmail-mcp
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
gmail-mcp es un servidor de contexto del modelo (MCP) diseñado para ejecutarse localmente o en infraestructura propia, conectándose directamente a la API oficial de Gmail. Su arquitectura elimina intermediarios, manteniendo los datos y tokens de autenticación dentro de tu entorno controlado.
El proyecto ofrece cinco herramientas principales: búsqueda avanzada con sintaxis nativa de Gmail, recuperación completa de mensajes (encabezados y cuerpo), gestión de hilos de conversación, creación de borradores para respuestas y listado de etiquetas. Todas las operaciones están limitadas a lectura y composición; no existen funciones para enviar, modificar o eliminar correos electrónicos.
La seguridad es un pilar central. Incluye un servidor de autorización OAuth 2.1 con flujo PKCE y validación mediante passphrase personal, protegiendo contra accesos no autorizados incluso si el endpoint se expone. El proyecto soporta despliegue nativo en contenedores Docker y Compose, requiriendo Python 3.10+ y configuración de credenciales OAuth estándar.
- Integración con LLMs locales (ej. Ollama) para consultar el historial de correo sin exponer datos a la nube.
- Conexión con ChatGPT Custom Connectors mediante HTTP para acceso seguro a Gmail desde aplicaciones SaaS.
- Auditoría y análisis de correos electrónicos automatizados dentro de flujos de trabajo de IA.
- Redacción automática de borradores de respuesta o seguimiento en hilos de conversación específicos.
- Acceso a metadatos de adjuntos (nombres y tamaños) para filtrar archivos sin descargarlos automáticamente.
- Servidor OAuth 2.1 integrado con soporte PKCE y gestión de tokens de refresco persistente.
- Ejecución estricta de permisos: solo gmail.readonly y gmail.compose, sin capacidades de envío o borrado.
- Protección contra re-enlace DNS mediante variable GMAIL_MCP_ALLOWED_HOSTS en despliegues HTTP.
- Compatibilidad nativa con clientes MCP vía stdio (local) y HTTP (alojado).
- Licencia MIT y arquitectura sin dependencias de terceros para el transporte de datos.
- Arquitectura single-tenant: autentifica como un único usuario de Gmail, no soporta login múltiple por usuario.
- No incluye funcionalidad de envío de correos; los borradores requieren intervención manual en la interfaz web.
- Requiere configuración manual de OAuth y gestión de secretos fuera del repositorio (git-ignored).
- Dependencia estricta de Python 3.10 o superior para el entorno de ejecución.
- El servidor HTTP requiere un proxy inverso con HTTPS para clientes alojados como ChatGPT.
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Para producción, utiliza un proxy inverso (Caddy o Nginx) con HTTPS obligatorio. Configura .env con variables de entorno seguras y evita exponer secrets/ en el sistema de archivos. Activa GMAIL_MCP_ALLOWED_HOSTS para limitar el acceso DNS. Ejecuta python authorize.py una vez para generar token.json antes de iniciar el contenedor.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.