Gmail MCP

Gmail MCP

Permite que Claude busque y recupere correos electrónicos de tu cuenta de Gmail.

Configuración

1. Obtén las Credenciales de la API de Google

1. Visita la Consola de Google Cloud
2. Crea un nuevo proyecto o selecciona uno existente
3. Habilita la API de Gmail para tu proyecto
   • Navega a "APIs y Servicios" > "Biblioteca"
   • Busca "Gmail API" y habilítala
4. Crea credenciales OAuth:
   • Ve a "APIs y Servicios" > "Credenciales"
   • Haz clic en "Crear Credenciales" > "ID de cliente OAuth"
   • Selecciona "Aplicación de escritorio" como tipo de aplicación
   • Nombra tu cliente y haz clic en "Crear"
5. Descarga el archivo JSON de credenciales
6. Guárdalo como credentials.json en el directorio de tu proyecto

2. Autoriza la Aplicación

Ejecuta el comando de autorización para generar tu token:

uv run gmail-mcp auth --creds-path credentials.json --token-path token.json

Esto abrirá una ventana del navegador donde deberás iniciar sesión en tu cuenta de Google y otorgar los permisos necesarios. Después de la autorización, se creará un archivo token.json en el directorio de tu proyecto.

Configuración con Claude

Agrega el servidor MCP de Gmail a tu archivo de configuración de Claude:

{
  "mcpServers": {
    "gmail": {
      "args": [
        "--from",
        "git+https://github.com/vinayak-mehta/gmail-mcp",
        "gmail-mcp"
      ],
      "command": "/Users/username/.local/bin/uvx",
      "env": {
        "GMAIL_CREDS_PATH": "/Users/username/path/to/gmail-mcp/credentials.json",
        "GMAIL_TOKEN_PATH": "/Users/username/path/to/gmail-mcp/token.json"
      }
    }
  }
}

Asegúrate de:

• Reemplazar /Users/username/path/to/gmail-mcp con la ruta real de tu proyecto
• Ajustar la ruta de command al ejecutable de uvx que tengas instalado
• Proporcionar las rutas correctas a tus archivos credentials.json y token.json

Claude ahora tendrá acceso a las siguientes herramientas:

1. Buscar Correos Electrónicos

Busca correos electrónicos en tu cuenta de Gmail.

Ejemplo de prompt: "Busca todos los correos electrónicos de example@gmail.com"

2. Obtener Contenido de un Correo Electrónico

Recupera el contenido completo de un correo electrónico específico.

Ejemplo de prompt: "Muéstrame el contenido completo del correo electrónico con el asunto 'Reunión Mañana'"

3. Listar Mensajes

Lista los mensajes recientes de tu bandeja de entrada de Gmail.

Ejemplo de prompt: "Lista mis 5 correos electrónicos más recientes"

Variables de Entorno

Puedes configurar las rutas a tus archivos de credenciales y token usando variables de entorno:

• GMAIL_CREDS_PATH: Ruta a tu archivo credentials.json
• GMAIL_TOKEN_PATH: Ruta a tu archivo token.json

Crea un archivo .env en la raíz del proyecto con estas variables para una configuración sencilla.