Configurazione dell'Automazione AI per Google Calendar
In questa configurazione, verrà collegato il server Google Calendar MCP.
Configurazione Google Cloud Console
L'API Google Calendar richiede una configurazione di progetto dedicata all'interno della Google Cloud Console. Questa procedura è simile alla configurazione di Gmail ma richiede autorizzazioni specifiche per l'API Calendar.
- Accedere alla Google Cloud Console tramite browser;
- Creare un nuovo progetto con un nome descrittivo (ad esempio, "gcalendar agent");
- Passare al nuovo progetto una volta completata l'inizializzazione.
- Se richiesto, cliccare su "Configura schermata di consenso";
- Inserire il nome dell'applicazione (ad esempio, "calendar mcp");
- Specificare l'indirizzo email autorizzato;
- Selezionare "Pubblico" come tipo di utenti;
- Fornire le informazioni di contatto utilizzando la stessa email;
- Accettare i requisiti della User Data Policy.
- Accedere a API e servizi → Libreria;
- Cercare "Calendar API";
- Selezionare il primo risultato e abilitare l'accesso all'API;
- Verificare che lo stato dell'API sia "Abilitato".
- Accedere alla sezione Credenziali in API e servizi;
- Creare un ID client OAuth;
- Selezionare "Applicazione desktop" come tipo di applicazione;
- Scaricare il file JSON delle credenziali generate;
- Salvare temporaneamente il file sul Desktop per un accesso rapido (opzionale).
Opzione 1: Eseguire i prompt in Claude (Consigliato)
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.
- Apri la cartella
Documents
; - Verifica la presenza di una nuova cartella
projects
; - All'interno, nel repository clonato, trova la nuova cartella (ad esempio,
google-calendar-mcp
). Il filegcp-oauth.keys.json
deve essere posizionato all'interno del repository.
Esegui 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"
}
}
- Apri Impostazioni → scorciatoia:
Cmd + ,
su Mac oCtrl + ,
su Windows; - Vai alla scheda Sviluppatore → clicca su Modifica Configurazione;
- Apri 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 al file delle credenziali; - Se corretto, chiudi la finestra di configurazione.
- Esci completamente da Claude (Mac:
Cmd + Q
, Windows:Alt + F4
); - Riavvia l'applicazione;
- Al riavvio, verrai reindirizzato a una pagina di autenticazione Google:
- Seleziona lo stesso account Google utilizzato per il progetto;
- Quando richiesto, clicca su Consenti per concedere l'accesso;
- Una volta visualizzato il messaggio di autenticazione avvenuta con successo, chiudi la scheda.
Opzione 2: Configurazione manuale (se l'Opzione 1 non funziona)
Nel Terminale (Mac) o nella Command Line (Windows), inizia dalla directory principale (impostazione predefinita) e naviga nella cartella dove verranno salvate tutte le future directory degli Agenti AI.
- Per accedere a una cartella, utilizza il comando
cd folder_name
, ad esempio:
cd Documents
Per creare una nuova cartella, utilizza il comando mkdir new_folder_name
, ad esempio:
mkdir projects
E naviga in questa nuova cartella con il comando cd command
:
cd projects
Utilizza il comando git clone link
per clonare il repo GitHub:
git clone https://github.com/nspady/google-calendar-mcp.git
Spostati nella repository appena creata utilizzando il comando cd
:
cd google-calendar-mcp
Se Git non è installato, scaricalo dal sito ufficiale Sito Git.
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 trovando 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; nel nostro caso, avvia il flusso di autenticazione.
- Si apre automaticamente una finestra del browser;
- Seleziona l'account Google appropriato;
- Concedi le autorizzazioni di accesso al calendario;
- Conferma il messaggio "Autenticazione riuscita";
- 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
.
- Riavvia completamente Claude Desktop;
- Verifica che il nuovo server appaia tra gli strumenti disponibili.
Grazie per i tuoi commenti!
Chieda ad AI
Chieda ad AI
Chieda pure quello che desidera o provi una delle domande suggerite per iniziare la nostra conversazione
Awesome!
Completion rate improved to 10
Configurazione dell'Automazione AI per Google Calendar
Scorri per mostrare il menu
In questa configurazione, verrà collegato il server Google Calendar MCP.
Configurazione Google Cloud Console
L'API Google Calendar richiede una configurazione di progetto dedicata all'interno della Google Cloud Console. Questa procedura è simile alla configurazione di Gmail ma richiede autorizzazioni specifiche per l'API Calendar.
- Accedere alla Google Cloud Console tramite browser;
- Creare un nuovo progetto con un nome descrittivo (ad esempio, "gcalendar agent");
- Passare al nuovo progetto una volta completata l'inizializzazione.
- Se richiesto, cliccare su "Configura schermata di consenso";
- Inserire il nome dell'applicazione (ad esempio, "calendar mcp");
- Specificare l'indirizzo email autorizzato;
- Selezionare "Pubblico" come tipo di utenti;
- Fornire le informazioni di contatto utilizzando la stessa email;
- Accettare i requisiti della User Data Policy.
- Accedere a API e servizi → Libreria;
- Cercare "Calendar API";
- Selezionare il primo risultato e abilitare l'accesso all'API;
- Verificare che lo stato dell'API sia "Abilitato".
- Accedere alla sezione Credenziali in API e servizi;
- Creare un ID client OAuth;
- Selezionare "Applicazione desktop" come tipo di applicazione;
- Scaricare il file JSON delle credenziali generate;
- Salvare temporaneamente il file sul Desktop per un accesso rapido (opzionale).
Opzione 1: Eseguire i prompt in Claude (Consigliato)
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.
- Apri la cartella
Documents
; - Verifica la presenza di una nuova cartella
projects
; - All'interno, nel repository clonato, trova la nuova cartella (ad esempio,
google-calendar-mcp
). Il filegcp-oauth.keys.json
deve essere posizionato all'interno del repository.
Esegui 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"
}
}
- Apri Impostazioni → scorciatoia:
Cmd + ,
su Mac oCtrl + ,
su Windows; - Vai alla scheda Sviluppatore → clicca su Modifica Configurazione;
- Apri 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 al file delle credenziali; - Se corretto, chiudi la finestra di configurazione.
- Esci completamente da Claude (Mac:
Cmd + Q
, Windows:Alt + F4
); - Riavvia l'applicazione;
- Al riavvio, verrai reindirizzato a una pagina di autenticazione Google:
- Seleziona lo stesso account Google utilizzato per il progetto;
- Quando richiesto, clicca su Consenti per concedere l'accesso;
- Una volta visualizzato il messaggio di autenticazione avvenuta con successo, chiudi la scheda.
Opzione 2: Configurazione manuale (se l'Opzione 1 non funziona)
Nel Terminale (Mac) o nella Command Line (Windows), inizia dalla directory principale (impostazione predefinita) e naviga nella cartella dove verranno salvate tutte le future directory degli Agenti AI.
- Per accedere a una cartella, utilizza il comando
cd folder_name
, ad esempio:
cd Documents
Per creare una nuova cartella, utilizza il comando mkdir new_folder_name
, ad esempio:
mkdir projects
E naviga in questa nuova cartella con il comando cd command
:
cd projects
Utilizza il comando git clone link
per clonare il repo GitHub:
git clone https://github.com/nspady/google-calendar-mcp.git
Spostati nella repository appena creata utilizzando il comando cd
:
cd google-calendar-mcp
Se Git non è installato, scaricalo dal sito ufficiale Sito Git.
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 trovando 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; nel nostro caso, avvia il flusso di autenticazione.
- Si apre automaticamente una finestra del browser;
- Seleziona l'account Google appropriato;
- Concedi le autorizzazioni di accesso al calendario;
- Conferma il messaggio "Autenticazione riuscita";
- 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
.
- Riavvia completamente Claude Desktop;
- Verifica che il nuovo server appaia tra gli strumenti disponibili.
Grazie per i tuoi commenti!