1. Accedere a Google Cloud Console;
2. Creare un nuovo progetto o selezionarne uno esistente;
3. Inserire il nome del progetto (ad esempio, "gmail mcp agent");
4. Accettare le impostazioni suggerite per organizzazione e posizione;
5. Fare clic su Crea e attendere l'inizializzazione del progetto.

1. Dal menu laterale, andare su "API e servizi" → "Libreria";
2. Cercare "Gmail API";
3. Selezionare il primo risultato e fare clic su "Abilita";
4. Questo concede al progetto il permesso di accedere alle funzionalità di Gmail.

1. Accedere alla scheda "Credenziali";
2. Se richiesto, fare clic su "Configura schermata di consenso";
3. Fare clic su "Inizia";
4. Inserire il nome dell'applicazione (ad esempio, "gmail agent");
5. Inserire il proprio indirizzo email;
6. Selezionare "Pubblico" come tipo di utente, se si utilizza un account Gmail generico;
7. Reinserire l'indirizzo email quando richiesto;
8. Accettare la policy sui dati utente;
9. Fare clic su Continua e Crea.

1. Fare clic su "Crea client OAuth";
2. Selezionare "Applicazione web";
3. Accettare il nome suggerito o personalizzarlo;
4. Fare clic su "Aggiungi URI";
5. Inserire il redirect URI: http://localhost:3000/oauth2callback;
6. Fare clic sul pulsante blu Crea;
7. Scaricare il file JSON delle credenziali;
8. Rinominare il file in: gsp-oauth.keys.json.

Accedere alla directory principale/home:

• Mac: cartella Home Users/user_name oppure Windows: C:\Users\Your_Username\;
• Usare Command + Shift + . (Mac) oppure Ctrl + Shift + . (Windows) per mostrare i file nascosti;
• Creare una nuova cartella chiamata: .gmail-mcp;
• Spostare il file gsp-oauth.keys.json in questa cartella;
• Usare nuovamente Command + Shift + . per nascondere le cartelle.

Il server è configurato per individuare automaticamente le credenziali in questa directory.

• Aprire Claude con Desktop Commander MCP installato. Per una configurazione rapida, utilizzare il comando Smithery;
• In una nuova chat di Claude, digitare il prompt:

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

• Durante l'esecuzione, Claude richiede l'autorizzazione per utilizzare Desktop Commander MCP. Fare clic su Consenti sempre o Consenti una volta;
• Si verrà reindirizzati a una pagina di autenticazione Google. Selezionare la stessa email utilizzata per il progetto Cloud. Fare clic su Consenti per concedere l'accesso a Gmail. Attendere il messaggio di successo;
• Riavviare Claude Desktop. Il nuovo server dovrebbe ora risultare connesso.

• Copiare il prompt e incollarlo in una nuova chat di Claude o in una già aperta:

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

• Eseguire il prompt → Claude aggiornerà il file di configurazione.
• Confermare che il blocco sia stato aggiunto correttamente (opzionale). Andare su Impostazioni (scorciatoia: Cmd + ,) → Sviluppatore → Modifica Configurazione → aprire il file claude_desktop_config.json in un editor di testo;
• Chiudere completamente e riaprire Claude Desktop.

Aggiornamento del file di configurazione

• In Claude Desktop, premere Command + , (Mac) o Ctrl + , (Windows);
• Fare clic su "Modifica Configurazione";
• Aprire il file di configurazione in un editor di testo;
• Copiare il blocco di configurazione;

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

• Incollarlo nel file di configurazione di Claude dopo il blocco di configurazione precedente e prima delle ultime due parentesi graffe di chiusura;
• Salvare il file (Command/Ctrl + S);
• Chiudere completamente e riaprire Claude Desktop.