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

Related MCP server: @kazuph/mcp-gmail-gas

✨ 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

1. Clonar el repositorio:

git clone https://github.com/yourusername/gmail-plugin.git
cd gmail-plugin

2. 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

3. 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

1. Dependencias de sincronización:

uv sync

2. Paquete de compilación:

uv build

3. 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

Indicaciones disponibles

🤝 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.