hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Integrations
Allows Claude Desktop to interact with Gmail accounts through Google Apps Script, enabling capabilities like searching emails, retrieving email content and details, and downloading attachments.
Uses Google Apps Script as the backend service to interface with Gmail, requiring users to deploy a script to their Google account that provides the necessary API endpoints for Gmail interaction.
Gmail de MCP
Servidor de Protocolo de Contexto de Modelo para la integración con Gmail. Esto permite que Claude Desktop (o cualquier cliente MCP) interactúe con su cuenta de Gmail a través de Google Apps Script.
Inicio rápido (para usuarios)
Prerrequisitos
- Node.js 18+ (instalación mediante
brew install node
) - Cuenta de Gmail
- Implementación de Google Apps Script
- Claude Desktop (instalación desde https://claude.ai/desktop )
Configuración
- Implementar Google Apps Script
- Visita Google Apps Script y crea un nuevo proyecto
- Copia todo el contenido de
code.gs
y pégalo en el editor de scripts - Haga clic en "Implementar" > "Nueva implementación"
- Seleccione "Aplicación web" como tipo de implementación
- Configure los siguientes ajustes:
- Ejecutar como: Yo
- ¿Quién tiene acceso?: Cualquiera
- Haga clic en "Implementar"
- Cuando se le solicite, revise y autorice la aplicación para acceder a su cuenta de Gmail
- Copie la URL de implementación y genere una clave API aleatoria para seguridad
Nota: El script requiere permisos de acceso a Gmail. Al implementar y ejecutar el script por primera vez, Google le solicitará que revise y otorgue estos permisos. Asegúrese de:
- Haga clic en "Revisar permisos"
- Selecciona tu cuenta de Google
- Haga clic en "Avanzado" si ve una advertencia.
- Haga clic en "Ir a [nombre de su proyecto] (no seguro)"
- Haga clic en "Permitir" para otorgar los permisos necesarios de Gmail.
- Abra el archivo de configuración de Claude Desktop en:
~/Library/Application Support/Claude/claude_desktop_config.json
Puedes encontrarlo a través del menú de Claude Desktop:
- Abra Claude Desktop
- Haga clic en Claude en la barra de menú de Mac
- Haga clic en "Configuración"
- Haga clic en "Desarrollador"
- Añade lo siguiente a tu configuración:
Nota: reemplace YOUR_DEPLOYMENT_URL
y YOUR_API_KEY
con sus valores reales.
Para desarrolladores
Prerrequisitos
- Node.js 18+ (instalación mediante
brew install node
) - Cuenta de Gmail
- Script de Google Apps
- Claude Desktop (instalación desde https://claude.ai/desktop )
- tsx (instalación mediante
npm install -g tsx
)
Instalación
Configuración de desarrollo
- Asegúrese de que Claude Desktop esté instalado y funcionando.
- Instale tsx globalmente si aún no lo ha hecho:
- Modifique la configuración de Claude Desktop ubicada en:
~/Library/Application Support/Claude/claude_desktop_config.json
Agregue lo siguiente a la configuración de su cliente MCP:
Herramientas disponibles
gmail_search_messages
: busca correos electrónicos usando la sintaxis de consulta de búsqueda de Gmail (p. ej., "asunto:Reunión más reciente que:1 día")gmail_get_message
: Obtenga el contenido completo y los detalles de un correo electrónico específicogmail_download_attachment
: descargar un archivo adjunto de un correo electrónico específico
Nota de seguridad
Mantén siempre en secreto tu clave VALID_API_KEY
y nunca la envíes al control de versiones. Esta clave ayuda a garantizar que solo los clientes autorizados puedan acceder a tu cuenta de Gmail mediante la implementación de Google Apps Script.
You must be authenticated.
Servidor de Protocolo de Contexto de Modelo para la integración con Gmail. Esto permite que Claude Desktop (o cualquier cliente MCP) interactúe con su cuenta de Gmail a través de Google Apps Script.