MCP Tools Reference: calendarmcp.googleapis.com

Narzędzie: suggest_time

Sugeruje przedziały czasu w jednym lub kilku kalendarzach.

Poniższy przykład pokazuje, jak użyć narzędzia curl do wywołania narzędzia MCP suggest_time.

Żądanie Curl 
curl --location 'https://calendarmcp.googleapis.com/mcp/v1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--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
}'

Schemat wejściowy

Wiadomość z żądaniem SuggestTime.

SuggestTimeRequest

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

  "timeZone": string

  "durationMinutes": integer

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

string

Wymagane. Adresy e-mail uczestników, dla których chcesz znaleźć wolny czas.
startTime

string

Wymagane. Początek przedziału czasu zapytania (ISO 8601).
endTime

string

Wymagane. Koniec przedziału czasu zapytania (ISO 8601).

Pole zbiorcze _time_zone.

_time_zone może mieć tylko jedną z tych wartości:
timeZone

string

Opcjonalnie. Strefa czasowa dla czasów wyszukiwania (identyfikator IANA, np. Europe/Zurich). Domyślnie: przesunięcie start_time, a jeśli go nie ma, to główna strefa czasowa użytkownika.

Pole zbiorcze _duration_minutes.

_duration_minutes może mieć tylko jedną z tych wartości:
durationMinutes

integer

Opcjonalnie. Minimalny czas trwania wolnego przedziału czasu w minutach. Domyślnie: 30.

Pole zbiorcze _preferences.

_preferences może mieć tylko jedną z tych wartości:
preferences

object (Preferences)

Ustawienia, które mają być używane do znajdowania sugerowanych godzin.

Ustawienia

Zapis JSON 
{

  "startHour": string

  "endHour": string

  "excludeWeekends": boolean

  "pageSize": integer
}
Pola

Pole zbiorcze _start_hour.

_start_hour może mieć tylko jedną z tych wartości:
startHour

string

Preferowana godzina rozpoczęcia w formacie „GG:mm” (24-godzinnym).

Pole zbiorcze _end_hour.

_end_hour może mieć tylko jedną z tych wartości:
endHour

string

Preferowana godzina zakończenia w formacie „GG:mm” (24-godzinnym).

Pole zbiorcze _exclude_weekends.

_exclude_weekends może mieć tylko jedną z tych wartości:
excludeWeekends

boolean

Wyklucz weekendy.

Pole zbiorcze _page_size.

_page_size może mieć tylko jedną z tych wartości:
pageSize

integer

Maksymalna liczba przedziałów czasu do zwrócenia. Domyślnie: 5.

Schemat wyjściowy

Wiadomość z odpowiedzią na SuggestTime.

SuggestTimeResponse

Zapis JSON 
{
  "timeSlots": [
    {
      object (TimeSlot)
    }
  ]
}
Pola
timeSlots[]

object (TimeSlot)

Sugerowane przedziały czasu.

TimeSlot

Zapis JSON 
{
  "startTime": string,
  "endTime": string,
  "durationMinutes": integer,
  "start": {
    object (DateOrDateTime)
  },
  "end": {
    object (DateOrDateTime)
  }
}
Pola
startTime
(deprecated)

string

Wycofane: zamiast tego używaj start.
endTime
(deprecated)

string

Wycofane: zamiast tego używaj end.
durationMinutes
(deprecated)

integer

Wycofane: zamiast tego używaj start i end do obliczania czasu trwania.
start

object (DateOrDateTime)

Godzina rozpoczęcia przedziału czasu.
end

object (DateOrDateTime)

Godzina zakończenia przedziału czasu.

DateOrDateTime

Zapis JSON 
{
  "date": string,
  "dateTime": string,
  "timeZone": string
}
Pola
date

string

Data w formacie ISO 8601 o północy UTC (np. '2019-11-20T00:00:00Z').
dateTime

string

Sygnatura czasowa w formacie ISO 8601 (np. '2019-11-20T08:19:06-07:00').
timeZone

string

Nazwa strefy czasowej TZDB.

Adnotacje narzędzia

Wskazówka dotycząca działania destrukcyjnego: ❌ | Wskazówka dotycząca działania idempotentnego: ✅ | Wskazówka dotycząca działania tylko do odczytu: ✅ | Wskazówka dotycząca działania w otwartym świecie: ❌

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.readonly
  • https://www.googleapis.com/auth/calendar.events
  • https://www.googleapis.com/auth/calendar.events.freebusy
  • https://www.googleapis.com/auth/calendar.freebusy