1. Toegang tot Google Cloud Console via browser;
2. Nieuw project aanmaken met een beschrijvende naam (bijv. "gcalendar agent");
3. Omschakelen naar het nieuw aangemaakte project zodra de initialisatie is voltooid.

0. Indien gevraagd, klik op "Toestemmingsscherm configureren";
1. Voer de naam van de applicatie in (bijv. "calendar mcp");
2. Geef het geautoriseerde e-mailadres op;
3. Selecteer "Externe doelgroep" voor gebruikersbeperkingen;
4. Verstrek contactinformatie met hetzelfde e-mailadres;
5. Accepteer de vereisten van het gebruikersgegevensbeleid.

1. Navigeer naar APIs en services → Bibliotheek;
2. Zoek naar "Calendar API";
3. Selecteer het eerste resultaat en schakel API-toegang in;
4. Controleer of de API-status "Ingeschakeld" weergeeft.

1. Ga naar het gedeelte Referenties in APIs en services;
2. Maak een OAuth-client-ID aan;
3. Selecteer "Desktopapplicatie" als applicatietype;
4. Download het gegenereerde JSON-referentiebestand;
5. Sla het bestand tijdelijk op het bureaublad op voor gemakkelijke toegang (optioneel).

Kopieer en plak de volgende prompt in Claude:

Create a new folder named projects in my Documents directory to store all MCP servers.
Then clone the repository using: git clone https://github.com/nspady/google-calendar-mcp.git into that folder.
After cloning, move the file gcp-oauth.keys.json from my Desktop into the cloned repo.

Claude maakt automatisch de map projects aan, kloont de repository en verplaatst het JSON-bestand met inloggegevens naar de repository.

• Open je Documents-map;
• Controleer of er een nieuwe projects-map is aangemaakt;
• Zoek in de gekloonde repo naar de nieuwe map (bijv. google-calendar-mcp). Het bestand gcp-oauth.keys.json is in de repo geplaatst.

Voer de volgende prompt uit in Claude:

add next config block to claude config file
    "google-calendar": {
      "command": "npx",
      "args": ["@cocal/google-calendar-mcp"],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS": "/path/to/your/gcp-oauth.keys.json"
      }
    }

• Open Instellingen → sneltoets: Cmd + , op Mac of Ctrl + , op Windows;
• Ga naar het tabblad Developer → klik op Edit Config;
• Open het bestand claude_desktop_config.json met een teksteditor. Het JSON-bestand toont nu het nieuwe config-blok met het juiste pad naar je inloggegevensbestand;
• Als dit klopt, sluit het configuratievenster.

• Sluit Claude volledig af (Mac: Cmd + Q, Windows: Alt + F4);
• Start de app opnieuw op;
• Bij het opstarten word je doorgestuurd naar een Google-authenticatiepagina:
  • Selecteer hetzelfde Google-account dat voor het project wordt gebruikt;
  • Klik op Toestaan wanneer hierom wordt gevraagd;
  • Zodra je ziet dat de authenticatie is geslaagd, sluit je het tabblad.

Open je Terminal (Mac) of Opdrachtprompt (Windows), begin vanuit de hoofdmap (standaard) en navigeer naar de map waar je alle toekomstige AI Agent-mappen wilt opslaan.

• Gebruik het commando cd folder_name om een map te openen, bijvoorbeeld:

cd Documents

Gebruik het commando mkdir new_folder_name om een nieuwe map aan te maken, bijvoorbeeld:

mkdir projects

Navigeer naar deze nieuwe map met het cd command-commando:

cd projects

Gebruik het commando git clone link om de GitHub-repository te klonen:

git clone https://github.com/nspady/google-calendar-mcp.git

Ga naar de nieuw aangemaakte repository met het cd-commando:

cd google-calendar-mcp

Nu moet het bestand met de inloggegevens worden verplaatst naar de map met de AI-agent (google_calendar_mcp). Dit kan handmatig door het bestandspictogram naar de geopende map in de bestandsverkenner te slepen. Of gebruik Terminal/Command Line en kopieer het bestand met het commando cp path/to/file_name ., bijvoorbeeld:

cp ~/Desktop/gsp-oauth.keys.json .

De punt (.) aan het einde geeft de huidige map aan als bestemming.

Controleer of het JSON-bestand succesvol is verplaatst naar de map door het ls-commando in de Terminal te gebruiken en de bestandsnaam in de lijst te zoeken.

Verwijder na het verplaatsen het bestand uit de oorspronkelijke locatie (bijvoorbeeld Desktop).

Gebruik in de Terminal/Command Line

npm install

Dit commando downloadt alle vereiste pakketten en afhankelijkheden.

Ga verder in Terminal/Command Line en voer uit

npm start

Dit commando voert het standaard startscript uit dat is gedefinieerd in het package.json-bestand van het project, wat doorgaans de applicatie of server opstart; in ons geval start het de authenticatiestroom.

1. Browservenster wordt automatisch geopend;
2. Selecteer het juiste Google-account;
3. Verleen machtigingen voor agenda-toegang;
4. Bevestig het bericht "Authenticatie geslaagd";
5. Sluit het browservenster.

Claude Desktop-integratie

• Kopieer configuratieblok:

    "google-calendar": {
      "command": "node",
      "args": [
        "/path/to/build/index.js"
      ]
    }

• Open Claude-configuratiebestand via Command/Ctrl + , → "Developer" → "Edit Config";
• Open het configuratiebestand claude_desktop_config.json met een teksteditor;
• Voeg de nieuwe configuratie toe als volgend blok na bestaande configuraties en vóór de twee laatste afsluitende accolades;
• Zorg voor correcte JSON-syntax met juiste accolades en komma's na elk configuratieblok, behalve na het laatste blok.

Voer in de Terminal/Command Line uit

pwd

Kopieer het volledige map-pad en voeg dit in vóór "/build" in het configuratiebestand.

Sla het configuratiebestand op met Command/Ctrl + S.

1. Herstart Claude Desktop volledig;
2. Controleer of de nieuwe server verschijnt bij de beschikbare tools.