A
securityA
licenseA
qualityProvides tools for interacting with Gmail and Calendar APIs. This server enables you to manage your emails and calendar events programmatically through the MCP interface.
Last updated -
25
MIT License
Servidor MCP del complemento de Gmail
Un potente servidor MCP que permite la integración con Gmail, lo que permite gestionar correos electrónicos directamente a través de clientes MCP. Este complemento proporciona acceso sin problemas a las funciones principales de Gmail, como leer, enviar y gestionar correos electrónicos.
Referencia : para ver un ejemplo de implementación de servidor MCP usando uvx, consulte este ejemplo .
🎥 Demostración
https://github.com/user-attachments/assets/df9e86cf-1f6b-4265-9c68-b3ed88103d1f
✨ Características
📧 Enviar y recibir correos electrónicos
📥 Leer mensajes no leídos
🗑️ Correos basura
📱Abrir correos electrónicos en el navegador
📝 Marcar correos electrónicos como leídos
🔒 Autenticación segura OAuth2
🚀 Inicio rápido
Prerrequisitos
Python 3.12 o superior
Credenciales de la API de Gmail
Cliente MCP (como Claude Desktop)
Instalación
Clonar el repositorio:
git clone https://github.com/yourusername/gmail-plugin.git
cd gmail-plugin
Instalar dependencias (elija un método):
# Method 1: Install in editable mode
uv pip install -e .
# Method 2: Install using requirements.txt
uv pip install -r requirements.txt
# Method 3: Install using uv sync (recommended)
uv sync --dev --all-extras
Configura tus credenciales de API de Gmail:
Crea un nuevo proyecto o selecciona uno existente
Habilitar la API de Gmail
Configurar la pantalla de consentimiento de OAuth:
Seleccione el tipo de usuario "Externo" (no requiere publicación)
Vaya a la pestaña Audiencias: agregue su correo electrónico como "Usuario de prueba"
Agregar ámbito OAuth:
https://www.googleapis.com/auth/gmail/modify
Crear credenciales OAuth 2.0:
Elija "Aplicación de escritorio" como tipo de aplicación
Descargar el archivo de credenciales JSON
Guarde el archivo de credenciales y anote su ruta absoluta (se utilizará para
--creds-file-path)
Configuración
Para servidores en desarrollo/no publicados
Agregue esto a la configuración de su cliente MCP:
"mcpServers": {
"gmail-plugin": {
"command": "uv",
"args": [
"--directory",
"[absolute path to working directory]",
"run",
"server.py"
"--creds-file-path",
"[absolute-path-to-credentials-file]",
"--token-path",
"[absolute-path-to-access-tokens-file]"
]
}
}
Para servidores publicados
"mcpServers": {
"gmail-plugin": {
"command": "uvx",
"args": [
"gmail-plugin"
]
}
}
🛠️ Desarrollo
Construcción y publicación
Dependencias de sincronización:
uv sync
Paquete de compilación:
uv build
Publicar en PyPI:
uv publish
Depuración
Utilice el Inspector MCP para depurar:
npx @modelcontextprotocol/inspector uv --directory C:\Users\sanch\Desktop\gmail_plugin\gmail-plugin run gmail-plugin
Referencia de API
Herramientas disponibles
Nombre de la herramienta | Descripción | Argumentos requeridos |
| Enviar un correo electrónico | destinatario_id, asunto, mensaje |
| Recuperar correos electrónicos no leídos | Ninguno |
| Leer el contenido del correo electrónico | ID de correo electrónico |
| Mover el correo electrónico a la papelera | ID de correo electrónico |
| Marcar correo electrónico como leído | ID de correo electrónico |
| Abrir el correo electrónico en el navegador | ID de correo electrónico |
Indicaciones disponibles
Nombre del aviso | Descripción | Argumentos |
| Actuar como administrador de correo electrónico | Ninguno |
| Redactar un nuevo correo electrónico | contenido, destinatario, correo electrónico del destinatario |
| Editar el borrador de correo electrónico existente | cambios, borrador_actual |
🤝 Contribuyendo
¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.
📄 Licencia
Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
Un servidor MCP que permite la integración de Gmail, permitiendo a los usuarios administrar correos electrónicos (enviar, recibir, leer, enviar a la papelera, marcar como leídos) directamente a través de clientes MCP como Claude Desktop.
Related MCP Servers
- AsecurityAlicenseAqualityModel Context Protocol server for Gmail integration. This allows Claude Desktop (or any MCP client) to interact with your Gmail account through Google Apps Script.Last updated -3012MIT License
- -securityAlicense-qualityIntegrates 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 -2GPL 3.0
- -securityAlicense-qualityMCP server that integrates with Gmail to enable sending, reading, and managing emails through tools like send-email, trash-email, get-unread-emails, and read-email.Last updated -59GPL 3.0