1. Navigeer naar Google Cloud Console;
2. Maak een nieuw project aan of selecteer een bestaand project;
3. Voer de projectnaam in (bijv. "gmail mcp agent");
4. Accepteer de voorgestelde organisatie- en locatiestandaarden;
5. Klik op Maken en wacht tot het project is geïnitialiseerd.

1. Ga in het zijmenu naar "APIs & Services" → "Library";
2. Zoek naar "Gmail API";
3. Selecteer het eerste resultaat en klik op "Inschakelen";
4. Hiermee krijgt je project toestemming om Gmail-functionaliteit te gebruiken.

1. Navigeer naar het tabblad "Credentials";
2. Klik indien gevraagd op "Configure consent screen";
3. Klik op "Aan de slag";
4. Voer de naam van de applicatie in (bijv. "gmail agent");
5. Vul je e-mailadres in;
6. Selecteer "External Audience" als gebruikersgroep als je een algemeen Gmail-account gebruikt;
7. Voer je e-mailadres opnieuw in wanneer daarom wordt gevraagd;
8. Accepteer het beleid voor gebruikersgegevens;
9. Klik op Doorgaan en Maken.

1. Klik op "Create OAuth Client";
2. Selecteer "Web Application";
3. Accepteer de voorgestelde naam of pas deze aan;
4. Klik op "Add URI";
5. Voer de redirect URI in: http://localhost:3000/oauth2callback;
6. Klik op de blauwe Maken knop;
7. Download het JSON-referentiebestand;
8. Hernoem het bestand naar: gsp-oauth.keys.json.

Navigeer naar je hoofdmap/thuisdirectory:

• Mac: Thuismap Users/user_name of Windows: C:\Users\Your_Username\;
• Gebruik Command + Shift + . (Mac) of Ctrl + Shift + . (Windows) om verborgen bestanden weer te geven;
• Maak een nieuwe map aan met de naam: .gmail-mcp;
• Verplaats het bestand gsp-oauth.keys.json naar deze map;
• Gebruik opnieuw Command + Shift + . om mappen te verbergen.

De server is geconfigureerd om automatisch referenties in deze directory te vinden.

• Open Claude met Desktop Commander MCP geïnstalleerd. Voor snelle installatie, gebruik Smithery-commando;
• Typ in een nieuw Claude-gesprek de prompt:

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

• Tijdens de uitvoering vraagt Claude toestemming om Desktop Commander MCP te gebruiken. Klik op Altijd toestaan of Eenmalig toestaan;
• Je wordt doorgestuurd naar een Google Auth-pagina. Selecteer hetzelfde e-mailadres dat voor het Cloud-project wordt gebruikt. Klik op Toestaan om Gmail-toegang te verlenen. Wacht op het Succesbericht;
• Herstart Claude Desktop. De nieuwe server zou nu als verbonden moeten verschijnen.

• Kopieer de prompt en plak deze in een nieuw of reeds geopend Claude-gesprek:

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

• Voer de prompt uit → Claude werkt het configuratiebestand bij.
• Controleer of het blok correct is toegevoegd (optioneel). Ga naar Instellingen (sneltoets: Cmd + ,) → Ontwikkelaar → Config bewerken → open het bestand claude_desktop_config.json in een teksteditor;
• Sluit Claude Desktop volledig af en open opnieuw.

Configuratiebestand bijwerken

• Druk in Claude Desktop op Command + , (Mac) of Ctrl + , (Windows);
• Klik op "Config bewerken";
• Open het configuratiebestand in een teksteditor;
• Kopieer het configuratieblok;

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

• Plak het in je Claude-configuratiebestand na het vorige configuratieblok en vóór de twee laatste sluitaccolades;
• Sla het bestand op (Command/Ctrl + S);
• Sluit Claude Desktop volledig af en open opnieuw.