1. Siirry osoitteeseen Google Cloud Console;
2. Luo uusi projekti tai valitse olemassa oleva;
3. Anna projektin nimi (esim. "gmail mcp agent");
4. Hyväksy ehdotetut organisaatio- ja sijaintiasetukset;
5. Napsauta Luo ja odota projektin alustusta.

1. Sivupalkista siirry kohtaan "APIs & Services" → "Library";
2. Etsi "Gmail API";
3. Valitse ensimmäinen tulos ja napsauta "Enable";
4. Tämä antaa projektille oikeudet käyttää Gmail-toimintoja.

1. Siirry "Credentials"-välilehdelle;
2. Jos pyydetään, napsauta "Configure consent screen";
3. Napsauta "Get started";
4. Anna sovelluksen nimi (esim. "gmail agent");
5. Syötä sähköpostiosoitteesi;
6. Valitse "External Audience" käyttäjätyypiksi, jos käytät yleistä Gmail-tiliä;
7. Syötä sähköpostiosoitteesi uudelleen pyydettäessä;
8. Hyväksy käyttäjätietopolitiikka;
9. Napsauta Jatka ja Luo.

1. Napsauta "Create OAuth Client";
2. Valitse "Web Application";
3. Hyväksy ehdotettu nimi tai muokkaa sitä;
4. Napsauta "Add URI";
5. Syötä uudelleenohjaus-URI: http://localhost:3000/oauth2callback;
6. Napsauta sinistä Luo-painiketta;
7. Lataa JSON-tunnistetiedostot;
8. Nimeä tiedosto uudelleen: gsp-oauth.keys.json.

Siirry juuri-/kotihakemistoosi:

• Mac: Kotikansio Users/user_name tai Windows: C:\Users\Your_Username\;
• Käytä Command + Shift + . (Mac) tai Ctrl + Shift + . (Windows) näyttääksesi piilotetut tiedostot;
• Luo uusi kansio nimeltä: .gmail-mcp;
• Siirrä gsp-oauth.keys.json-tiedosto tähän kansioon;
• Käytä Command + Shift + . uudelleen piilottaaksesi kansiot.

Palvelin on määritetty etsimään tunnistetiedot automaattisesti tästä kansiosta.

• Avaa Claude, johon on asennettu Desktop Commander MCP. Nopeaan käyttöönottoon käytä Smithery-komentoa;
• Uudessa Claude-keskustelussa kirjoita kehotteeksi:

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

• Suorituksen aikana Claude pyytää lupaa käyttää Desktop Commander MCP:tä. Napsauta Salli aina tai Salli kerran;
• Sinut ohjataan Google Auth -sivulle. Valitse sama sähköposti, jota käytettiin Cloud-projektissa. Napsauta Salli myöntääksesi Gmail-oikeudet. Odota Onnistumisviestiä;
• Käynnistä Claude Desktop uudelleen. Uuden palvelimen tulisi nyt näkyä yhdistettynä.

• Kopioi kehoteteksti ja liitä se Claudeen uuteen tai jo avattuun keskusteluun:

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

• Suorita kehoteteksti → Claude päivittää asetustiedoston.
• Varmista, että lohko lisättiin oikein (valinnainen). Siirry kohtaan Asetukset (pikanäppäin: Cmd + ,) → Kehittäjä → Muokkaa asetuksia → avaa claude_desktop_config.json -tiedosto tekstieditorissa;
• Sulje Claude Desktop kokonaan ja avaa se uudelleen.

Päivitä asetustiedosto

• Claude Desktopissa paina Command + , (Mac) tai Ctrl + , (Windows);
• Napsauta "Muokkaa asetuksia";
• Avaa asetustiedosto tekstieditorissa;
• Kopioi asetusten lohko;

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

• Liitä se Claude-asetustiedostoon edellisen asetusten lohkon jälkeen ja ennen kahta viimeistä sulkevaa aaltosuljetta;
• Tallenna tiedosto (Command/Ctrl + S);
• Sulje Claude Desktop kokonaan ja avaa se uudelleen.