Gmail MCP

Permita que Claude busque y recupere correos electrónicos de su cuenta de Gmail.

Configuración

1. Obtener las credenciales de la API de Google

1. Visita la consola de Google Cloud

2. Crea un nuevo proyecto o selecciona uno existente

3. Habilite la API de Gmail para su proyecto

   • Vaya a "API y servicios" > "Biblioteca".

   • Busque "API de Gmail" y habilítela

4. Crear credenciales OAuth:

   • Vaya a "API y servicios" > "Credenciales".

   • Haga clic en "Crear credenciales" > "ID de cliente OAuth".

   • Seleccione "Aplicación de escritorio" como tipo de aplicación

   • Nombra a tu cliente y haz clic en "Crear"

5. Descargar el archivo JSON de credenciales

6. Guárdelo como credentials.json en el directorio de su proyecto

2. Autorizar la solicitud

Ejecute el comando de autorización para generar su token:

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

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

Related MCP server: Gmail MCP Server

Configurando con Claude

Agregue el servidor MCP de Gmail a su 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úrese de:

• Reemplace /Users/username/path/to/gmail-mcp con la ruta real de su proyecto

• Ajuste la ruta command a su ejecutable uvx instalado

• Proporcione rutas correctas a sus 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 mensaje: "Buscar todos los correos electrónicos de ejemplo@gmail.com "

2. Obtener contenido de correo electrónico

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

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

3. Lista de mensajes

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

Ejemplo de mensaje: "Enumerar mis 5 correos electrónicos más recientes"

Variables de entorno

Puede configurar las rutas a sus credenciales y archivos de token mediante variables de entorno:

• GMAIL_CREDS_PATH : Ruta a su archivo credentials.json

• GMAIL_TOKEN_PATH : Ruta a su archivo token.json

Cree un archivo .env en la raíz del proyecto con estas variables para una fácil configuración.