1. Acceder a Google Cloud Console;
2. Crear un proyecto nuevo o seleccionar uno existente;
3. Ingresar el nombre del proyecto (por ejemplo, "gmail mcp agent");
4. Aceptar la organización y ubicación sugeridas;
5. Hacer clic en Crear y esperar la inicialización del proyecto.

1. Desde el menú lateral, ir a "APIs y servicios" → "Biblioteca";
2. Buscar "Gmail API";
3. Seleccionar el primer resultado y hacer clic en "Habilitar";
4. Esto otorga permiso a tu proyecto para acceder a la funcionalidad de Gmail.

1. Navegar a la pestaña "Credenciales";
2. Si se solicita, hacer clic en "Configurar pantalla de consentimiento";
3. Hacer clic en "Comenzar";
4. Ingresar el nombre de la aplicación (por ejemplo, "gmail agent");
5. Ingresar tu dirección de correo electrónico;
6. Seleccionar "Audiencia externa" como tipo de usuario, si utilizas una cuenta general de Gmail;
7. Volver a ingresar tu dirección de correo electrónico cuando se solicite;
8. Aceptar la política de datos de usuario;
9. Hacer clic en Continuar y Crear.

1. Hacer clic en "Crear cliente OAuth";
2. Seleccionar "Aplicación web";
3. Aceptar el nombre sugerido o personalizarlo;
4. Hacer clic en "Agregar URI";
5. Ingresar el URI de redirección: http://localhost:3000/oauth2callback;
6. Hacer clic en el botón azul Crear;
7. Descargar el archivo de credenciales JSON;
8. Renombrar el archivo a: gsp-oauth.keys.json.

Navegar a tu directorio raíz/principal:

• Mac: Carpeta de inicio Users/user_name o Windows: C:\Users\Your_Username\;
• Usar Command + Shift + . (Mac) o Ctrl + Shift + . (Windows) para mostrar archivos ocultos;
• Crear una nueva carpeta llamada: .gmail-mcp;
• Mover el archivo gsp-oauth.keys.json a esta carpeta;
• Usar Command + Shift + . nuevamente para ocultar las carpetas.

El servidor está configurado para localizar automáticamente las credenciales en este directorio.

• Abrir Claude con Desktop Commander MCP instalado. Para una configuración rápida, utilizar el comando Smithery;
• En un nuevo chat de Claude, escribir el siguiente prompt:

run npx -y @smithery/cli install @gongrzhe/server-gmail-autoauth-mcp --client claude

• Durante la ejecución, Claude solicitará permiso para usar Desktop Commander MCP. Hacer clic en Permitir siempre o Permitir una vez;
• Serás redirigido a una página de autenticación de Google. Selecciona el mismo correo electrónico utilizado para el proyecto de Cloud. Haz clic en Permitir para otorgar acceso a Gmail. Espera el mensaje de éxito;
• Reinicia Claude Desktop. El nuevo servidor debería aparecer ahora como conectado.

• Copia el prompt y pégalo en un chat nuevo o ya abierto de Claude:

add next config block to claude config file
{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "@gongrzhe/server-gmail-autoauth-mcp"
      ]
    }
  }
}

• Ejecuta el prompt → Claude actualizará el archivo de configuración.
• Confirma que el bloque fue añadido correctamente (opcional). Ve a Configuración (acceso directo: Cmd + ,) → Desarrollador → Editar configuración → abre el archivo claude_desktop_config.json en un editor de texto;
• Cierra completamente y vuelve a abrir Claude Desktop.

Actualizar archivo de configuración

• En Claude Desktop, presiona Command + , (Mac) o Ctrl + , (Windows);
• Haz clic en "Editar configuración";
• Abre el archivo de configuración en un editor de texto;
• Copia el bloque de configuración;

{
  "mcpServers": {
    "desktop-commander": {
      "command": "npx",
      "args": [
        "-y",
        "@wonderwhy-er/desktop-commander"
      ]
    },
    "gmail": {
      "command": "npx",
      "args": [
        "@gongrzhe/server-gmail-autoauth-mcp"
      ]
    }
  }
}

• Pégalo en tu archivo de configuración de Claude después del bloque de configuración anterior y antes de las dos últimas llaves de cierre;
• Guarda el archivo (Command/Ctrl + S);
• Cierra completamente y vuelve a abrir Claude Desktop.