1. Toegang tot Google Cloud Console via de 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 beleid voor gebruikersgegevens.

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-referentiebestand naar de repository.

• Open uw Documents-map;
• Controleer of er een nieuwe projects-map is aangemaakt;
• Zoek binnen de gekloonde repository naar de nieuwe map (bijvoorbeeld google-calendar-mcp). Het bestand gcp-oauth.keys.json is in de repository 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 moet nu het nieuwe configuratieblok tonen met het juiste pad naar uw referentiebestand;
• Indien correct, sluit het configuratievenster.

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

Open in uw Terminal (Mac) of Opdrachtprompt (Windows), begin vanuit de hoofdmap (standaard) en navigeer naar de map waar u 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 start; in dit 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-syntaxis 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 plaats dit vóór "/build" in het configuratiebestand.

Sla het configuratiebestand op met Command/Ctrl + S.

1. Start Claude Desktop volledig opnieuw op;
2. Controleer of de nieuwe server verschijnt in de beschikbare tools.