1. Gå til Google Cloud Console;
2. Opprett et nytt prosjekt eller velg et eksisterende;
3. Skriv inn prosjektnavn (f.eks. "gmail mcp agent");
4. Godta foreslåtte innstillinger for organisasjon og plassering;
5. Klikk Opprett og vent til prosjektet er initialisert.

1. Gå til sidemenyen og velg "API-er og tjenester" → "Bibliotek";
2. Søk etter "Gmail API";
3. Velg det første resultatet og klikk "Aktiver";
4. Dette gir prosjektet ditt tilgang til Gmail-funksjonalitet.

1. Gå til fanen "Legitimasjon";
2. Klikk på "Konfigurer samtykkeskjerm" hvis du blir bedt om det;
3. Klikk "Kom i gang";
4. Skriv inn applikasjonsnavn (f.eks. "gmail agent");
5. Skriv inn e-postadressen din;
6. Velg "Ekstern målgruppe" for brukertype hvis du bruker en vanlig Gmail-konto;
7. Skriv inn e-postadressen din på nytt når du blir bedt om det;
8. Godta retningslinjene for brukerdata;
9. Klikk Fortsett og Opprett.

1. Klikk "Opprett OAuth-klient";
2. Velg "Webapplikasjon";
3. Godta foreslått navn eller tilpass det;
4. Klikk "Legg til URI";
5. Skriv inn omdirigerings-URI: http://localhost:3000/oauth2callback;
6. Klikk på den blå Opprett-knappen;
7. Last ned JSON-legitimasjonsfilen;
8. Gi filen nytt navn til: gsp-oauth.keys.json.

Gå til hjemmekatalogen/rotmappen din:

• Mac: Hjem-mappe Users/user_name eller Windows: C:\Users\Your_Username\;
• Bruk Command + Shift + . (Mac) eller Ctrl + Shift + . (Windows) for å vise skjulte filer;
• Opprett en ny mappe med navnet: .gmail-mcp;
• Flytt filen gsp-oauth.keys.json inn i denne mappen;
• Bruk Command + Shift + . igjen for å skjule mapper.

Serveren er konfigurert til automatisk å finne legitimasjon i denne katalogen.

• Åpne Claude med Desktop Commander MCP installert. For rask oppsett, bruk Smithery-kommandoen;
• I en ny Claude-chat, skriv inn følgende prompt:

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

• Under kjøring vil Claude be om tillatelse til å bruke Desktop Commander MCP. Klikk Tillat alltid eller Tillat én gang;
• Du blir omdirigert til en Google Auth-side. Velg samme e-postadresse som ble brukt for Cloud-prosjektet. Klikk Tillat for å gi tilgang til Gmail. Vent på Suksessmelding;
• Start Claude Desktop på nytt. Den nye serveren skal nå vises som tilkoblet.

• Kopier prompten og lim den inn i en ny eller allerede åpen Claude-chat:

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

• Kjør prompten → Claude vil oppdatere konfigurasjonsfilen.
• Bekreft at blokken ble lagt til riktig (valgfritt). Gå til Innstillinger (snarvei: Cmd + ,) → Utvikler → Rediger konfigurasjon → åpne claude_desktop_config.json-filen i en teksteditor;
• Lukk og åpne Claude Desktop helt på nytt.

Oppdatere konfigurasjonsfil

• I Claude Desktop, trykk Command + , (Mac) eller Ctrl + , (Windows);
• Klikk "Rediger konfigurasjon";
• Åpne konfigurasjonsfilen i en teksteditor;
• Kopier konfigurasjonsblokken;

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

• Lim den inn i Claude-konfigurasjonsfilen etter forrige konfigurasjonsblokk og før de to siste lukkende krøllparentesene;
• Lagre filen (Command/Ctrl + S);
• Lukk og åpne Claude Desktop helt på nytt.