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.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

How are these scores calculated?

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

@kazuph/mcp-gmail-gas
kazuph
A
security
A
license
A
quality
Model 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 -
3
7
8
JavaScript
MIT License
Gmail MCP Server
jmonsellier
-
security
A
license
-
quality
Integrates 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 -
Python
GPL 3.0
Systemprompt MCP Gmail Server
Ejb503
-
security
F
license
-
quality
Enables users to manage Gmail accounts using AI agent-assisted operations via an MCP protocol, supporting email search, reading, deletion, and sending with a voice-powered interface.
Last updated -
2
5
TypeScript
Email Sending MCP
resend
A
security
F
license
A
quality
A simple MCP server that enables users to send emails using Resend's API, integrating with tools like Cursor and Claude Desktop for seamless email composition and delivery.
Last updated -
1
6
321
TypeScript

View all related MCP servers

Gmail Plugin MCP Server