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 "Määritä suostumusnäyttö";
1. Syötä sovelluksen nimi (esim. "calendar mcp");
2. Määritä valtuutettu sähköpostiosoite;
3. Valitse "Ulkoinen yleisö" käyttäjätyypin rajoituksiin;
4. Anna yhteystiedot käyttäen samaa sähköpostiosoitetta;
5. Hyväksy käyttäjätietopolitiikan 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 "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 tietovaraston ja siirtää tunnistetiedoston JSON-tiedoston repo-kansioon.

• Avaa Documents-kansiosi;
• Tarkista, että uusi projects-kansio on luotu;
• Sisällä, kloonatussa repossa, etsi uusi kansio (esim. google-calendar-mcp). Tiedosto gcp-oauth.keys.json 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äytettiin projektiin;
  • Kun pyydetään, napsauta Salli myöntääksesi käyttöoikeuden;
  • Kun näet ilmoituksen onnistuneesta todennuksesta, sulje välilehti.

Avaa pääte (Mac) tai komentorivi (Windows), aloita juurihakemistosta (oletuksena) ja siirry kansioon, johon tallennat kaikki tulevat AI Agent -hakemistot.

• Kansioon siirtyminen tapahtuu komennolla cd folder_name, esimerkiksi:

cd Documents

Uuden kansion luominen tapahtuu komennolla mkdir new_folder_name, esimerkiksi:

mkdir projects

Ja siirry tähän uuteen kansioon komennolla cd command:

cd projects

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

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

Siirry uuteen tietovarastoon komennolla 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 vetämällä tiedoston kuvakkeen auki olevaan kansioon tiedostoselaimessa. Tai käytä Terminaalia/komentoriviä 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 siirtyi kansioon onnistuneesti käyttämällä ls-komentoa Terminaalissa ja etsimällä tiedoston nimen listasta.

Tiedoston siirron jälkeen poista se alkuperäisestä sijainnista (esim. Desktop).

Terminaalissa/komentorivillä käytä

npm install

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

Jatka työskentelyä Terminaalissa/komentorivillä 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, oikeat sulut ja pilkut jokaisen määrityslohkon jälkeen paitsi viimeisen.

Terminaalissa/komentorivillä suorita

pwd

Kopioi koko hakemistopolku ja lisää se ennen "/build" 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.