local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Allows searching and retrieving emails from a Gmail account, with capabilities to search for specific emails, retrieve full email content, and list recent messages from the inbox.
Uses Google Cloud Console for API credentials and OAuth authentication to enable Gmail access.

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

Visita la consola de Google Cloud
Crea un nuevo proyecto o selecciona uno existente
Habilite la API de Gmail para su proyecto
- Vaya a "API y servicios" > "Biblioteca".
- Busque "API de Gmail" y habilítela
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"
Descargar el archivo JSON de credenciales
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.

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.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Un servidor que permite a Claude buscar y recuperar correos electrónicos de su cuenta de Gmail, admitiendo funciones como buscar correos electrónicos, recuperar el contenido completo de correos electrónicos específicos y enumerar mensajes recientes.

Related Resources

Reddit Discussion about this server