Come collegare Cal.com a Gemini via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Cal.com, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Cal.com + Gemini

Leggi un account di pianificazione Cal.com da Claude, ChatGPT o Copilot: tipi di evento, prenotazioni con partecipanti, registrazioni e trascrizioni di Cal Video, slot liberi, piani di disponibilità e calendari collegati. Prenotare, spostare e annullare sono inclusi ma disattivati all'installazione.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

CALCOM_API_HOST, CALCOM_API_KEY

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti. Ti serve un account Cal.com (qualsiasi piano) per creare una chiave API personale. La chiave agisce come l'utente che l'ha creata.

1. Accedi a Cal.com e apri Settings → Developer → API Keys (su app.cal.com, oppure su app.cal.eu se il tuo account è nella regione UE di Cal.com).
2. Clicca su New, dai alla chiave un nome (per esempio AnythingMCP) e una scadenza, e copiala. Inizia con cal_live_ (o cal_test_ in modalità test) e viene mostrata una sola volta.
3. Incolla solo la chiave, senza la parola Bearer, in CALCOM_API_KEY.
4. Imposta CALCOM_API_HOST su https://api.cal.com se accedi da app.cal.com, oppure su https://api.cal.eu se accedi da app.cal.eu. Inseriscilo senza /v2, percorsi o barra finale: il connettore aggiunge /v2 da solo. Una chiave funziona solo nella sua regione.
5. Installa il connettore ed esegui calcom_get_me: mostra l'utente a cui appartiene la chiave, con fuso orario e piano predefinito, e conferma che chiave e host vanno insieme.

Di chi sono i dati: tipi di evento, prenotazioni e piani di disponibilità del proprietario della chiave, più le prenotazioni di team in cui quell'utente è host o admin. Chi usa il connettore lavora con quell'unico account, quindi usa la chiave della persona (o dell'admin del team) di cui l'AI deve vedere gli appuntamenti.

Cosa legge: i tuoi tipi di evento (i modelli di appuntamento prenotabili) con durata, luoghi, campi di prenotazione, tempi cuscinetto, preavviso minimo e link di prenotazione; le prenotazioni con stato, orari, link della riunione, host, partecipanti con email e fuso orario, ospiti e risposte alle domande di prenotazione; le registrazioni e trascrizioni Cal Video di una prenotazione; gli slot liberi di un tipo di evento; i tuoi piani di disponibilità con orari settimanali ed eccezioni per singole date; e i calendari collegati (Google, Outlook, Apple, CalDAV), compresi quelli controllati per i conflitti e quello in cui vengono scritte le nuove prenotazioni.

La uid della prenotazione, non l'id: gli strumenti sulle prenotazioni vogliono la uid, una stringa che l'AI prende da calcom_list_bookings, non l'id numerico. La uid di una prenotazione ricorrente restituisce tutte le occorrenze. Le prenotazioni si filtrano per stato (upcoming, past, cancelled, unconfirmed), partecipante, tipo di evento, team o date, e arrivano a pagine.

Fusi orari: gli slot liberi tornano nel fuso orario in cui ragioni tu, che l'AI passa a calcom_get_available_slots, mentre gli orari di inizio delle prenotazioni vanno a Cal.com in UTC. Gli slot tengono già conto di calendari, tempi cuscinetto, preavviso minimo e limiti.

Registrazioni e trascrizioni: esistono solo per le riunioni Cal Video, e solo l'organizzatore, un admin del team o un admin dell'organizzazione può leggerle. Le riunioni su Zoom, Google Meet o Teams qui non ne hanno. Una trascrizione esiste se qualcuno ha cliccato Transcribe durante la call, e il suo link di download vale un'ora: se serve, l'AI ne chiede uno nuovo.

Disattivati all'installazione: calcom_create_booking, calcom_reschedule_booking e calcom_cancel_booking. Mandano email a partecipanti reali e modificano calendari reali: una nuova prenotazione invia conferme e inviti (i tipi di evento a pagamento possono chiedere al partecipante di pagare), lo spostamento annulla la vecchia prenotazione e ne crea una nuova con una nuova uid, e un annullamento non si può revocare (su una prenotazione ricorrente annulla tutte le occorrenze). Un amministratore può attivarli uno per uno.

Chiede prima di ogni modifica: quando uno strumento di scrittura è attivo, l'AI controlla prima l'orario con calcom_get_available_slots, poi ti mostra tipo di evento, orario nel tuo fuso, partecipante e ospiti o il motivo, e aspetta il tuo sì.

Limiti: Cal.com consente circa 120 richieste al minuto per chiave API. Dopo un 429 l'AI aspetta un minuto prima di riprovare.

Errori comuni: 401 Invalid API Key significa che la chiave è sbagliata, scaduta o eliminata, oppure appartiene all'altra regione. 403 indica che la chiave funziona ma questo utente non vede quella prenotazione, quel tipo di evento o quel team: usa la chiave dell'organizzatore o di un admin del team. 404 di solito significa che è stato usato un id numerico al posto della uid della prenotazione. Con 400 Cal.com indica il campo che non ha accettato, spesso un orario di inizio che non è uno slot libero.

Il connettore non modifica tipi di evento, piani di disponibilità o calendari collegati, e non incassa né rimborsa pagamenti.

Step 2 — Installa l'adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Step 3 — Aggiungi il connettore in Gemini

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di Cal.com.

Tool disponibili

Esempi di prompt

• "Che appuntamenti ho domani, e chi partecipa a ciascuno?"
• "Trovami tre slot liberi la prossima settimana per il mio tipo di evento Call conoscitiva, in ora italiana, da proporre a un cliente."
• "Prendi la trascrizione della call di ieri con Rossi Srl ed elenca le azioni che abbiamo concordato."
• "Quali prenotazioni sono state annullate o spostate questo mese, e con quali motivazioni?"
• "Quali sono i miei orari di lavoro nel piano predefinito, e quali calendari controlla Cal.com per i conflitti?"

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT