Servidor MCP de Gmail

Un servidor MCP (Protocolo de contexto de modelo) que proporciona capacidades de integración de Gmail a clientes MCP como Claude Desktop.

Características

Ver correos electrónicos recientes desde tu bandeja de entrada de Gmail
Buscar correos electrónicos usando la sintaxis de búsqueda de Gmail
Autenticación segura de OAuth2 con la API de Gmail

Configuración

1. Configuración del proyecto de Google Cloud

Crea un proyecto de Google Cloud en https://console.cloud.google.com/
Habilitar la API de Gmail
Crear credenciales OAuth 2.0:
- Tipo de aplicación: Aplicación de escritorio
- Descargue las credenciales como credentials.json

2. Instalación

# Create a conda environment
conda create -n mcp-gmail python=3.12
conda activate mcp-gmail

# Install the package
cd gmail-mcp-server
pip install -e .

3. Configuración para Claude Desktop

Añade a tu claude_desktop_config.json :

{
  "mcpServers": {
    "gmail": {
      "command": "/path/to/conda/envs/mcp-gmail/bin/python",
      "args": ["-m", "gmail_mcp_server.server"],
      "env": {
        "PYTHONPATH": "/path/to/gmail-mcp-server/src",
        "GMAIL_CREDENTIALS_FILE": "/path/to/credentials.json",
        "GMAIL_TOKEN_FILE": "/path/to/token.json"
      }
    }
  }
}

Reemplace /path/to/ con sus rutas actuales. El archivo de token se creará automáticamente al autenticarse por primera vez.

4. Primera ejecución

La primera vez que intentes acceder a Gmail a través de Claude, se te solicitará que autorices la aplicación en tu navegador. Tras la autorización, tus credenciales se guardarán en el archivo de token para su uso posterior.

Recursos disponibles

gmail://inbox/recent - Devuelve sus 10 correos electrónicos más recientes

Herramientas disponibles

search_emails
- Descripción: Busca correos electrónicos de Gmail con una consulta
- Parámetros:
  - query (obligatoria): consulta de búsqueda de Gmail (utiliza la sintaxis de búsqueda estándar de Gmail)
  - max_results (opcional): Número máximo de resultados a devolver (predeterminado: 10)

Ejemplo de búsqueda:

Could you show me any emails from sanrio in the last two days?

Seguridad

Este servidor requiere autenticación OAuth2 con Gmail:

Se le solicitará que autorice el acceso en su navegador la primera vez que lo use.
Las credenciales se almacenan localmente en el archivo de token especificado
El acceso se puede revocar en cualquier momento a través de la configuración de su cuenta de Google.
Solo se solicita acceso de lectura a Gmail (no permisos de escritura)

Variables de entorno

GMAIL_CREDENTIALS_FILE (obligatorio): Ruta a su archivo de credenciales de Google OAuth
GMAIL_TOKEN_FILE (obligatorio): Ruta donde se guardará el token de autenticación

Para realizar pruebas, puede ejecutar el servidor directamente:

GMAIL_CREDENTIALS_FILE="/path/to/credentials.json" \
GMAIL_TOKEN_FILE="/path/to/token.json" \
python -m gmail_mcp_server.server

Desarrollo

El servidor utiliza el Protocolo de Contexto de Modelo para proporcionar:

Acceso a recursos a correos electrónicos recientes
Soporte de herramientas para búsqueda de correo electrónico
Flujo de autenticación segura de OAuth2
Actualización automática del token

Explotación florestal

El servidor registra información detallada sobre sus operaciones en stderr, incluyendo:

Información de inicio del servidor
Estado de autenticación
Uso de recursos y herramientas
Cualquier error o problema

Contribuyendo

¡Las solicitudes de extracción son bienvenidas! Por favor, asegúrese de:

Actualizar la documentación para cualquier característica nueva
Añadir un manejo de errores adecuado
Pruebe el flujo de OAuth con nuevas funciones
Seguir el estilo de código existente

Gmail MCP Server

Integrations