1. Accedere alla Google Cloud Console tramite browser;
2. Creare un nuovo progetto con un nome descrittivo (ad esempio, "gcalendar agent");
3. Passare al nuovo progetto una volta completata l'inizializzazione.

0. Se richiesto, cliccare su "Configura schermata di consenso";
1. Inserire il nome dell'applicazione (ad esempio, "calendar mcp");
2. Specificare l'indirizzo email autorizzato;
3. Selezionare "Pubblico" per le restrizioni sul tipo di utente;
4. Fornire le informazioni di contatto utilizzando lo stesso indirizzo email;
5. Accettare i requisiti della User Data Policy.

1. Accedere a API e servizi → Libreria;
2. Cercare "Calendar API";
3. Selezionare il primo risultato e abilitare l'accesso all'API;
4. Verificare che lo stato dell'API sia "Abilitato".

1. Accedere alla sezione Credenziali in API e servizi;
2. Creare ID client OAuth;
3. Selezionare "Applicazione desktop" come tipo di applicazione;
4. Scaricare il file JSON delle credenziali generate;
5. Salvare temporaneamente il file sul Desktop per un accesso rapido (opzionale).

In Claude, copia e incolla il seguente prompt:

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 creerà automaticamente la cartella projects, clonerà il repository e sposterà il file JSON delle credenziali all'interno del repository.

• Aprire la cartella Documents;
• Verificare la presenza di una nuova cartella projects;
• All'interno, nel repository clonato, trovare la nuova cartella (ad esempio, google-calendar-mcp). Il file gcp-oauth.keys.json deve essere posizionato all'interno del repository.

Eseguire il seguente prompt 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"
      }
    }

• Aprire Impostazioni → scorciatoia: Cmd + , su Mac o Ctrl + , su Windows;
• Accedere alla scheda Sviluppatore → cliccare su Modifica Configurazione;
• Aprire il file claude_desktop_config.json con un editor di testo. Il file JSON dovrebbe ora mostrare il nuovo blocco di configurazione con il percorso corretto del file delle credenziali;
• Se corretto, chiudere la finestra di configurazione.

• Uscire completamente da Claude (Mac: Cmd + Q, Windows: Alt + F4);
• Riavviare l'applicazione;
• Al riavvio, si verrà reindirizzati a una pagina di autenticazione Google:
  • Selezionare lo stesso account Google utilizzato per il progetto;
  • Quando richiesto, cliccare su Consenti per concedere l'accesso;
  • Una volta visualizzato il messaggio di autenticazione avvenuta con successo, chiudere la scheda.

Nel Terminale (Mac) o nella Command Line (Windows), partire dalla directory principale (impostazione predefinita) e navigare nella cartella dove verranno memorizzate tutte le future directory degli Agenti AI.

• Per accedere a una cartella, utilizzare il comando cd folder_name, ad esempio:

cd Documents

Per creare una nuova cartella, utilizzare il comando mkdir new_folder_name, ad esempio:

mkdir projects

E navigare in questa nuova cartella con il comando cd command:

cd projects

Utilizzare il comando git clone link per clonare il repository GitHub:

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

Spostarsi nel repository appena creato utilizzando il comando cd:

cd google-calendar-mcp

Ora è necessario spostare il file con le credenziali nella cartella dell'agente AI (google_calendar_mcp). Puoi farlo manualmente trascinando l'icona del file nella cartella aperta tramite il file explorer. Oppure utilizza il Terminale/Prompt dei comandi e copia il file con il comando cp path/to/file_name ., ad esempio:

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

Il punto (.) alla fine indica la directory corrente come destinazione.

Puoi verificare se il file JSON è stato spostato correttamente nella cartella utilizzando il comando ls nel Terminale e cercando il nome del file nell'elenco.

Dopo aver spostato il file, eliminalo dalla posizione originale (ad esempio, Desktop).

Nel Terminale/Prompt dei comandi utilizza

npm install

Questo comando scarica tutti i pacchetti e le dipendenze necessari.

Continua a lavorare nel Terminale/Prompt dei comandi ed esegui

npm start

Questo comando esegue lo script di avvio predefinito definito nel file package.json del progetto, che tipicamente avvia l'applicazione o il server; in questo caso, avvia il flusso di autenticazione.

1. La finestra del browser si apre automaticamente;
2. Seleziona l'account Google appropriato;
3. Concedi le autorizzazioni di accesso al calendario;
4. Conferma il messaggio "Autenticazione riuscita";
5. Chiudi la finestra del browser.

Integrazione con Claude Desktop

• Copia il blocco di configurazione:

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

• Accedi al file di configurazione di Claude tramite Command/Ctrl + , → "Developer" → "Edit Config";
• Apri il file di configurazione claude_desktop_config.json con un editor di testo;
• Aggiungi la nuova configurazione come blocco successivo dopo le configurazioni esistenti e prima delle ultime due parentesi graffe di chiusura;
• Assicurati della corretta sintassi JSON con la chiusura corretta delle parentesi e le virgole dopo ogni blocco di configurazione, tranne l'ultimo.

Nel Terminale/Prompt dei comandi esegui

pwd

Copia il percorso completo della directory e inseriscilo prima di "/build" nel file di configurazione.

Salva il file di configurazione con Command/Ctrl + S.

1. Riavvia completamente Claude Desktop;
2. Verifica che il nuovo server appaia tra gli strumenti disponibili.