MCP Tools Reference: calendarmcp.googleapis.com

Strumento: suggest_time

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 oraria di 30 minuti in cui siamo entrambi disponibili.
  • Verifica 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.

Il seguente esempio mostra come utilizzare curl per richiamare lo strumento MCP suggest_time.

Richiesta curl 
curl --location 'https://calendarmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "suggest_time",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Schema di input

Messaggio di richiesta per SuggestTime.

SuggestTimeRequest

Rappresentazione JSON 
{
  "attendeeEmails": [
    string
  ],
  "startTime": string,
  "endTime": string,

  "timeZone": string

  "durationMinutes": integer

  "preferences": {
    object (Preferences)
  }
}
Campi
attendeeEmails[]

string

Obbligatorio. Gli indirizzi email dei partecipanti per cui trovare tempo libero.
startTime

string

Obbligatorio. L'inizio dell'intervallo per la query formattato in base a ISO 8601.
endTime

string

Obbligatorio. La fine dell'intervallo per la query formattato in base a ISO 8601.

Campo unione _time_zone.

_time_zone può essere solo uno dei seguenti tipi:
timeZone

string

Facoltativo. Il fuso orario utilizzato per i valori di tempo. Questo campo accetta i nomi dei database dei fusi orari IANA, ad es. America/Los_Angeles. Il valore predefinito è il fuso orario del calendario principale dell'utente.

Campo unione _duration_minutes.

_duration_minutes può essere solo uno dei seguenti tipi:
durationMinutes

integer

Facoltativo. La durata minima di una fascia oraria libera in minuti. Il valore predefinito è 30 minuti.

Campo unione _preferences.

_preferences può essere solo uno dei seguenti tipi:
preferences

object (Preferences)

Le preferenze per trovare l'orario suggerito.

Preferences

Rappresentazione JSON 
{

  "startHour": string

  "endHour": string

  "excludeWeekends": boolean

  "pageSize": integer
}
Campi

Campo unione _start_hour.

_start_hour può essere solo uno dei seguenti tipi:
startHour

string

L'ora di inizio preferita del giorno (ad es. 09:00).

Campo unione _end_hour.

_end_hour può essere solo uno dei seguenti tipi:
endHour

string

L'ora di fine preferita del giorno (ad es. 17:00).

Campo unione _exclude_weekends.

_exclude_weekends può essere solo uno dei seguenti tipi:
excludeWeekends

boolean

Indica se escludere i fine settimana.

Campo unione _page_size.

_page_size può essere solo uno dei seguenti tipi:
pageSize

integer

Il numero massimo di fasce orarie da restituire. Il valore predefinito è 5.

Schema di output

Messaggio di risposta per SuggestTime.

SuggestTimeResponse

Rappresentazione JSON 
{
  "timeSlots": [
    {
      object (TimeSlot)
    }
  ]
}
Campi
timeSlots[]

object (TimeSlot)

Elenco delle fasce orarie suggerite.

TimeSlot

Rappresentazione JSON 
{
  "startTime": string,
  "endTime": string,
  "durationMinutes": integer
}
Campi
startTime

string

L'ora di inizio della fascia oraria libera come timestamp formattato in base a ISO 8601.
endTime

string

L'ora di fine della fascia oraria libera come timestamp formattato in base a ISO 8601.
durationMinutes

integer

La durata della fascia oraria libera in minuti.

Annotazioni dello strumento

Suggerimento distruttivo: ❌ | Suggerimento idempotente: ✅ | Suggerimento di sola lettura: ✅ | Suggerimento open world: ❌