MCP Reference: calendarmcp.googleapis.com

Elenca gli eventi di calendario in un determinato calendario che soddisfano le condizioni specificate.

Funzionalità principali:

• Qualsiasi ID calendario, che può essere il calendario principale dell'utente o altri.
• Filtro per intervallo di tempo.
• Recupera TUTTI gli eventi che corrispondono ai vincoli di tempo.

Se disponibile, utilizza invece lo strumento search_events per le ricerche nel calendario principale dell'utente se:

• Stai eseguendo una query per gli eventi che corrispondono a un argomento, una categoria o un intento specifico (ad es. "riunioni per il pranzo", "sincronizzazioni del progetto").
• Devi trovare gli eventi più pertinenti (i primi K) anziché tutti gli eventi che soddisfano i vincoli.
• Hai bisogno di funzionalità di ricerca semantica o per parole chiave.

Utilizza questo strumento per query come:

• Cosa è segnato sul mio calendario per domani?
• Cosa è segnato sul mio calendario per il 14 luglio 2025?
• Quali sono le mie riunioni della prossima settimana?
• Ho conflitti questo pomeriggio?

• Quali riunioni ha Mario domani?

Esempio:

list_events(
    startTime='2024-09-17T06:00:00',
    endTime='2024-09-17T12:00:00',
    pageSize=10
)
# Returns up to 10 calendar events between 6:00 AM and 12:00 PM on September 17, 2024 from the user's primary calendar.

Restituisce un singolo evento da un determinato calendario.

Utilizza questo strumento per query come:

• Ottieni i dettagli della riunione del team.
• Mostrami l'evento con ID event123 sul mio calendario.

Esempio:

get_event(
    eventId='event123'
)
# Returns the event details for the event with id `event123` on the user's primary calendar.

Restituisce i calendari nell'elenco dei calendari dell'utente.

Utilizza questo strumento per query come:

• Quali sono tutti i miei calendari?

Esempio:

list_calendars()
# Returns all calendars the authenticated user has access to.

Suggerisce periodi di tempo in uno o più calendari. Per accedere al calendario principale, aggiungi "primary" nel campo attendee_emails.

Utilizza questo strumento per query come:

• Quando siamo tutti liberi per una riunione?
• Trova una fascia di 30 minuti in cui siamo entrambi disponibili.
• Controlla se jane.doe@google.com è libera lunedì mattina.

Esempio:

suggest_time(
    attendeeEmails=['joedoe@gmail.com', 'janedoe@gmail.com'],
    startTime='2024-09-10T00:00:00',
    endTime='2024-09-17T00:00:00',
    durationMinutes=60,
    preferences={
        'startHour': '09:00',
        'endHour': '17:00',
        'excludeWeekends': True
    }
)
# Returns up to 5 suggested time slots where both users are available for at least one hour between 9:00 AM and 5:00 PM on weekdays from September 10 through September 16, 2024.

Crea un evento di calendario.

Utilizza questo strumento per query come:

• Crea un evento sul mio calendario per domani alle 14:00 chiamato "Riunione con Jane".
• Pianifica una riunione con john.doe@google.com lunedì prossimo dalle 10:00 alle 11:00.

Esempio:

create_event(
    summary='Meeting with Jane',
    startTime='2024-09-17T14:00:00',
    endTime='2024-09-17T15:00:00'
)
# Creates an event on the primary calendar for September 17, 2024 from 2pm to 3pm called 'Meeting with Jane'.

Aggiorna un evento di calendario.

Utilizza questo strumento per query come:

• Aggiorna l'evento "Riunione con Jane" in modo che sia un'ora dopo.
• Aggiungi john.doe@google.com alla riunione di domani.

Esempio:

update_event(
    eventId='event123',
    summary='Meeting with Jane and John'
)
# Updates the summary of event with id 'event123' on the primary calendar to 'Meeting with Jane and John'.

Elimina un evento di calendario.

Utilizza questo strumento per query come:

• Elimina l'evento con ID event123 sul mio calendario.

Per annullare o rifiutare un evento, utilizza invece lo strumento respond_to_event.

Esempio:

delete_event(
    eventId='event123'
)
# Deletes the event with id 'event123' on the user's primary calendar.

Risponde a un evento.

Utilizza questo strumento per query come:

• Accetta l'evento con ID event123 sul mio calendario.
• Rifiuta la riunione con Jane.
• Annulla la mia prossima riunione.
• Accetta provvisoriamente la riunione di pianificazione.

Esempio:

respond_to_event(
    eventId='event123',
    responseStatus='accepted'
)
# Responds with status 'accepted' to the event with id 'event123' on the user's primary calendar.