Enables complete email management through Gmail, including sending emails with attachments, reading and searching emails, managing labels and organization, handling drafts, and performing batch operations on multiple emails.
Integrates with Google Cloud for authentication and API access, allowing the MCP server to securely connect to Gmail services through OAuth 2.0 credentials.
Un potente servidor de Protocolo de Contexto de Modelo (MCP) que permite a Claude AI interactuar directamente con Gmail.
El servidor MCP de Gmail es una implementación integral que permite a asistentes de IA como Claude interactuar directamente con Gmail mediante lenguaje natural. Ofrece un amplio conjunto de herramientas para la gestión del correo electrónico, lo que facilita una integración fluida entre la IA conversacional y tu bandeja de entrada.
credentials.json en la raíz del proyectoEjecute el servidor una vez para autenticarse:
Se abrirá una ventana del navegador que te solicitará que te autentiques con tu cuenta de Google. Tras la autenticación, se creará un archivo token.json que se guardará para su uso posterior.
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonNota: Reemplace "/absolute/path/to/gmail-mcp-server/gmail_server.py" con la ruta absoluta real al archivo gmail_server.py en su repositorio clonado.
El servidor MCP de Gmail expone las siguientes herramientas a Claude:
send_email - Envía correos electrónicos básicos con contenido de texto/HTMLsend_email_with_attachment - Enviar correos electrónicos con archivos adjuntossend_email_with_multiple_attachments - Envía correos electrónicos con múltiples archivos adjuntosread_email - Lee el contenido de un correo electrónico específico por IDget_unread_emails - Obtener una lista de correos electrónicos no leídosget_important_emails - Obtener correos electrónicos marcados como importantesget_emails_with_attachments - Recibir correos electrónicos con archivos adjuntosget_recent_emails - Recibe correos electrónicos de los últimos X díassearch_emails - Buscar correos electrónicos usando la sintaxis de consulta de Gmailget_email_labels - Lista todas las etiquetas/carpetas de Gmailcreate_email_label - Crea una nueva etiquetadelete_email_label - Eliminar una etiqueta existentelabel_email - Aplicar una etiqueta a un correo electrónicoremove_email_label - Eliminar una etiqueta de un correo electrónicomark_as_read - Marcar un correo electrónico como leídomark_as_unread - Marcar un correo electrónico como no leídodelete_email - Mover un correo electrónico a la papeleracreate_email_draft - Crea un nuevo borrador de correo electrónicoupdate_email_draft - Actualizar un borrador existentelist_email_drafts - Lista de borradores disponiblessend_draft - Enviar un borrador existentebatch_apply_label - Aplicar una etiqueta a varios correos electrónicosbatch_delete_emails - Mover varios correos electrónicos a la papeleraget_email_profile - Obtener información del perfil de Gmailsummarize_recent_emails - Crea un resumen de correos electrónicos recientesA continuación se muestran algunos ejemplos de indicaciones para Claude:
El servidor admite múltiples variables de entorno para personalización:
| Variable | Descripción |
|---|---|
GMAIL_TOKEN_PATH | Ruta personalizada para almacenar el token OAuth |
GMAIL_CREDENTIALS_PATH | Ruta personalizada a las credenciales de OAuth |
GOOGLE_CLIENT_ID | ID de cliente OAuth (alternativa al archivo de credenciales) |
GOOGLE_CLIENT_SECRET | Secreto de cliente OAuth (alternativa al archivo de credenciales) |
MCP_PORT | Puerto para transporte SSE (predeterminado: 3000) |
DEBUG | Habilitar el modo de depuración ( true o false ) |
El servidor se puede ejecutar en modo SSE (eventos enviados por el servidor) para la integración basada en HTTP:
Esto inicia el servidor en el puerto especificado (predeterminado: 3000), haciéndolo accesible a través de HTTP.
¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.
git checkout -b feature/amazing-feature )git commit -m 'Add some amazing feature' )git push origin feature/amazing-feature )Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.
This server cannot be installed
Un servidor de protocolo de contexto de modelo que permite a Claude AI interactuar con Gmail, admitiendo el envío, la lectura, la búsqueda, el etiquetado, la gestión de borradores y las operaciones por lotes de correo electrónico a través de comandos de lenguaje natural.