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.

Related MCP server: Gmail API MCP Server

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

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