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:
- Ir a la consola de Google Cloud
- 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
`send-email`	Enviar un correo electrónico	destinatario_id, asunto, mensaje
`get-unread-emails`	Recuperar correos electrónicos no leídos	Ninguno
`read-email`	Leer el contenido del correo electrónico	ID de correo electrónico
`trash-email`	Mover el correo electrónico a la papelera	ID de correo electrónico
`mark-email-as-read`	Marcar correo electrónico como leído	ID de correo electrónico
`open-email`	Abrir el correo electrónico en el navegador	ID de correo electrónico

Indicaciones disponibles

Nombre del aviso	Descripción	Argumentos
`manage-email`	Actuar como administrador de correo electrónico	Ninguno
`draft-email`	Redactar un nuevo correo electrónico	contenido, destinatario, correo electrónico del destinatario
`edit-draft`	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.

Gmail Plugin MCP Server

Integrations