1. Siirry Google Cloud Console -palveluun selaimella;
2. Luo uusi projekti kuvaavalla nimellä (esim. "gcalendar agent");
3. Vaihda uuteen projektiin, kun alustus on valmis.

0. Jos pyydetään, napsauta "Configure consent screen";
1. Syötä sovelluksen nimi (esim. "calendar mcp");
2. Määritä valtuutettu sähköpostiosoite;
3. Valitse "External Audience" käyttäjätyypin rajoitukseksi;
4. Anna yhteystiedot käyttäen samaa sähköpostiosoitetta;
5. Hyväksy User Data Policy -vaatimukset.

1. Siirry kohtaan APIs and Services → Library;
2. Etsi "Calendar API";
3. Valitse ensimmäinen tulos ja ota API käyttöön;
4. Varmista, että API-tila näkyy muodossa "Enabled".

1. Siirry Credentials-osioon kohdassa APIs and Services;
2. Luo OAuth client ID;
3. Valitse sovellustyypiksi "Desktop Application";
4. Lataa luotu JSON-tunnistetiedostotiedosto;
5. Tallenna tiedosto väliaikaisesti työpöydälle helppoa käyttöä varten (valinnainen).

Claudeen kopioi ja liitä seuraava kehotus:

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 luo automaattisesti projects-kansion, kloonaa repositorion ja siirtää tunnistetiedoston JSON-tiedoston repo-kansioon.

• Avaa Documents-kansiosi;
• Tarkista, että uusi projects-kansio on luotu;
• Sisällä, kloonatussa repositoriossa, etsi uusi kansio (esim. google-calendar-mcp). gcp-oauth.keys.json -tiedosto on sijoitettu repo-kansioon.

Suorita seuraava kehotus Claudessa:

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"
      }
    }

• Avaa asetukset → pikanäppäin: Cmd + , Macilla tai Ctrl + , Windowsilla;
• Siirry Kehittäjä-välilehdelle → napsauta Muokkaa asetuksia;
• Avaa claude_desktop_config.json -tiedosto tekstieditorilla. JSON-tiedostossa tulisi nyt näkyä uusi konfiguraatiolohko, jossa on oikea polku tunnistetiedostoon;
• Jos tiedot ovat oikein, sulje asetukset.

• Sulje Claude kokonaan (Mac: Cmd + Q, Windows: Alt + F4);
• Käynnistä sovellus uudelleen;
• Käynnistyksen yhteydessä sinut ohjataan Google-todennussivulle:
  • Valitse sama Google-tili, jota käytetään projektissa;
  • Kun pyydetään, napsauta Salli myöntääksesi käyttöoikeudet;
  • Kun näet ilmoituksen onnistuneesta todennuksesta, sulje välilehti.

Avaa Terminal (Mac) tai Komentorivi (Windows) ja aloita juurihakemistosta (oletuksena) ja siirry kansioon, johon tallennat kaikki tulevat AI Agent -hakemistot.

• Kansioon siirtyminen: käytä komentoa cd folder_name, esimerkiksi:

cd Documents

Kansion luominen: käytä komentoa mkdir new_folder_name, esimerkiksi:

mkdir projects

Siirry tähän uuteen kansioon cd command-komennolla:

cd projects

Käytä komentoa git clone link kloonataksesi GitHub-repositorio:

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

Siirry uuteen repositorioon käyttämällä komentoa cd:

cd google-calendar-mcp

Nyt sinun tulee siirtää tunnistetiedot sisältävä tiedosto AI-agentin kansioon (google_calendar_mcp). Tämän voi tehdä manuaalisesti siirtämällä tiedoston kuvakkeen tiedostoselaimessa avattuun kansioon. Tai käytä Terminaalia/Komentoikkunaa ja kopioi tiedosto komennolla cp path/to/file_name ., esimerkiksi:

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

Piste (.) lopussa määrittää nykyisen kansion kohteeksi.

Voit tarkistaa, että JSON-tiedosto on siirretty onnistuneesti kansioon käyttämällä ls-komentoa Terminaalissa ja etsimällä tiedostonimen listasta.

Tiedoston siirtämisen jälkeen poista se alkuperäisestä sijainnistaan (esim. Desktop).

Terminaalissa/Komentoikkunassa käytä

npm install

Tämä komento lataa kaikki tarvittavat paketit ja riippuvuudet.

Jatka työskentelyä Terminaalissa/Komentoikkunassa ja suorita

npm start

Tämä komento suorittaa projektin package.json-tiedostossa määritellyn oletuskäynnistysskriptin, joka tyypillisesti käynnistää sovelluksen tai palvelimen; tässä tapauksessa se käynnistää todennusprosessin.

1. Selainikkuna avautuu automaattisesti;
2. Valitse sopiva Google-tili;
3. Myönnä kalenterin käyttöoikeudet;
4. Vahvista "Tunnistautuminen onnistui" -viesti;
5. Sulje selainikkuna.

Claude Desktop -integraatio

• Kopioi määrityslohko:

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

• Avaa Claude-asetustiedosto painamalla Command/Ctrl + , → "Kehittäjä" → "Muokkaa asetuksia";
• Avaa asetustiedosto claude_desktop_config.json tekstieditorilla;
• Lisää uusi määritys seuraavana lohkona olemassa olevien määritysten jälkeen ja ennen kahta viimeistä sulkevaa aaltosuljetta;
• Varmista oikea JSON-syntaksi, oikea sulkujen määrä ja pilkut jokaisen määrityslohkon jälkeen paitsi viimeisen.

Terminaalissa/Komentoikkunassa suorita

pwd

Kopioi koko hakemistopolku ja lisää se ennen "/build"-osaa asetustiedostossa.

Tallenna asetustiedosto Command/Ctrl + S.

1. Käynnistä Claude Desktop kokonaan uudelleen;
2. Varmista, että uusi palvelin näkyy käytettävissä olevissa työkaluissa.