@kazuph/mcp-gmail-gas

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

  1. 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:

  1. Haga clic en "Revisar permisos"
  2. Selecciona tu cuenta de Google
  3. Haga clic en "Avanzado" si ve una advertencia.
  4. Haga clic en "Ir a [nombre de su proyecto] (no seguro)"
  5. Haga clic en "Permitir" para otorgar los permisos necesarios de Gmail.
  6. 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:

  1. Abra Claude Desktop
  2. Haga clic en Claude en la barra de menú de Mac
  3. Haga clic en "Configuración"
  4. Haga clic en "Desarrollador"
  5. Añade lo siguiente a tu configuración:
{ "tools": { "gmail": { "command": "npx", "args": ["-y", "@kazuph/mcp-gmail-gas"], "env": { "GAS_ENDPOINT": "YOUR_DEPLOYMENT_URL", "VALID_API_KEY": "YOUR_API_KEY" } } } }

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

git clone https://github.com/kazuph/mcp-gmail-gas.git cd mcp-gmail-gas npm install npm run build

Configuración de desarrollo

  1. Asegúrese de que Claude Desktop esté instalado y funcionando.
  2. Instale tsx globalmente si aún no lo ha hecho:
npm install -g tsx # or pnpm add -g tsx
  1. 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:

{ "tools": { "gmail": { "args": ["tsx", "/path/to/mcp-gmail-gas/index.ts"], "env": { "GAS_ENDPOINT": "YOUR_DEPLOYMENT_URL", "VALID_API_KEY": "YOUR_API_KEY" } } } }

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ífico
  • gmail_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.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

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.

  1. Quick Start (For Users)
    1. Prerequisites
    2. Configuration
  2. For Developers
    1. Prerequisites
    2. Installation
    3. Development Configuration
  3. Available Tools
    1. Security Note
      ID: 7awla69pjq