Gmail Auto-Auth MCP Server
by GongRzhe
Integración completa con Gmail con autenticación OAuth automática para asistentes de IA
communication Node.js Intermedio Auto-hospedable Docker
⭐ 1.0k stars 📦 34.9k/week 📅 Actualizado: hace 8m
Descripción
Un servidor MCP para Gmail que destaca por su flujo de autenticación OAuth2 automático — abre el navegador, gestiona el callback y almacena las credenciales globalmente para que la configuración se haga una sola vez. Proporciona 19 herramientas que cubren operaciones de email (enviar, borrador, leer, buscar, eliminar), soporte completo de adjuntos (enviar, recibir, descargar), gestión integral de etiquetas (CRUD), operaciones en lote para hasta 50 emails a la vez, y creación avanzada de filtros con plantillas predefinidas. Soporta emails HTML y multipart con codificación de caracteres internacionales. Con más de 34.000 descargas semanales en npm, es uno de los servidores MCP de Gmail más utilizados.
✅ Ideal para
Desarrolladores que quieren integración Gmail sin complicaciones con asistentes de IA y necesitan capacidades completas de gestión de email
⏭️ No recomendado si
Necesitas soporte multi-proveedor de email o prefieres un flujo OAuth del lado del servidor sin interacción con el navegador
💡 Casos de uso
- Enviar y redactar emails con adjuntos a través de asistentes de IA
- Buscar y organizar la bandeja de entrada usando la sintaxis avanzada de búsqueda de Gmail
- Automatizar el etiquetado y filtrado de emails con reglas basadas en plantillas
- Procesamiento en lote de emails para clasificación o limpieza
- Leer y descargar adjuntos de email para extracción de datos
👍 Ventajas
- ✓ Autenticación OAuth2 automática — sin configuración manual de tokens
- ✓ Más de 34.000 descargas semanales en npm, bien probado en producción
- ✓ Soporte completo de adjuntos para enviar, recibir y descargar
- ✓ Operaciones en lote manejan hasta 50 emails a la vez
- ✓ Plantillas de filtros para escenarios comunes como auto-etiquetado
👎 Desventajas
- ✗ Requiere configuración de credenciales OAuth de Google Cloud (una sola vez)
- ✗ Limitado a Gmail — no soporta otros proveedores de email
- ✗ 71 issues abiertas sugieren que algunos casos límite no están resueltos
🔧 Herramientas expuestas (15 herramientas)
| Tool | Categoría | Descripción |
|---|---|---|
| batch_modify_emails | batch-operations | Modificar etiquetas de múltiples emails eficientemente en lotes de hasta 50 |
| batch_delete_emails | batch-operations | Eliminar permanentemente múltiples emails en lotes |
| send_email | email-operations | Enviar emails nuevos con asunto, contenido, adjuntos opcionales y destinatarios |
| draft_email | email-operations | Crear borradores de email sin enviar, con soporte de adjuntos |
| read_email | email-operations | Recuperar contenido de email específico por ID con información de adjuntos |
| download_attachment | email-operations | Descargar adjuntos de email al sistema de archivos local |
| search_emails | email-operations | Buscar emails usando la sintaxis de búsqueda de Gmail |
| modify_email | email-operations | Añadir o eliminar etiquetas de emails |
| delete_email | email-operations | Eliminar permanentemente un email |
| create_filter | filter-management | Crear filtros de Gmail con criterios y acciones personalizados |
| list_filters | filter-management | Recuperar todos los filtros de Gmail |
| create_filter_from_template | filter-management | Crear filtros usando plantillas predefinidas para escenarios comunes |
| list_email_labels | label-management | Recuperar todas las etiquetas de Gmail disponibles |
| create_label | label-management | Crear nuevas etiquetas de Gmail |
| get_or_create_label | label-management | Obtener etiqueta existente o crear si no existe |
💡 Consejos y trucos
Ejecuta 'npx @gongrzhe/server-gmail-autoauth-mcp auth' una vez para completar el flujo OAuth. Las credenciales se almacenan globalmente en ~/.gmail-mcp/credentials.json así que funcionan desde cualquier directorio. Usa create_filter_from_template para reglas de bandeja de entrada rápidas.
Info rápida
- Autor
- GongRzhe
- Licencia
- MIT
- Runtime
- Node.js 18+
- Transporte
- stdio
- Categoría
- communication
- Dificultad
- Intermedio
- Auto-hospedable
- ✅
- Auth
- —
- Docker
- 🐳 Docker disponible
- Versión
- 1.1.11
- Actualizado
- 6 ago 2025
Compatibilidad con clientes
- ❓ Claude Code
- ❓ Cursor
- ❓ VS Code Copilot
- ❓ Gemini CLI
- ❓ Windsurf
- ❓ Cline
- ❓ JetBrains AI
- ❓ Warp
Plataformas
🍎 macOS 🐧 Linux 🪟 Windows