MCP Reference: calendarmcp.googleapis.com

Wyświetla listę wydarzeń w kalendarzu, które spełniają określone warunki.

Najważniejsze funkcje:

• Dowolny identyfikator kalendarza, który może być kalendarzem głównym użytkownika lub innym kalendarzem.
• Filtrowanie według zakresu czasu.
• Pobiera WSZYSTKIE wydarzenia spełniające ograniczenia czasowe.

Jeśli jest dostępna, użyj narzędzia search_events do wyszukiwania w kalendarzu głównym użytkownika, jeśli:

• szukasz wydarzeń pasujących do określonego tematu, kategorii lub intencji (np. „spotkania przy lunchu”, „synchronizacje projektu”);
• musisz znaleźć (najlepsze K) najbardziej odpowiednie wydarzenia, a nie wszystkie wydarzenia spełniające ograniczenia;
• potrzebujesz funkcji wyszukiwania słów kluczowych lub wyszukiwania semantycznego.

Użyj tego narzędzia do zapytań takich jak:

• Co mam jutro w kalendarzu?
• Co mam w kalendarzu na 14 lipca 2025 r.?
• Jakie mam spotkania w przyszłym tygodniu?
• Czy mam jakieś konflikty w tym tygodniu?

• Jakie spotkania ma Janek jutro?

Przykład:

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.

Zwraca pojedyncze wydarzenie z danego kalendarza.

Użyj tego narzędzia do zapytań takich jak:

• Pobierz szczegóły spotkania zespołu.
• Pokaż mi wydarzenie o identyfikatorze event123 w moim kalendarzu.

Przykład:

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

Zwraca kalendarze na liście kalendarzy użytkownika.

Użyj tego narzędzia do zapytań takich jak:

• Jakie mam kalendarze?

Przykład:

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

Sugeruje przedziały czasu w co najmniej 1 kalendarzu. Aby uzyskać dostęp do kalendarza głównego, dodaj „primary” w polu attendee_emails.

Użyj tego narzędzia do zapytań takich jak:

• Kiedy wszyscy będziemy wolni na spotkanie?
• Znajdź 30-minutowe okienko, w którym oboje będziemy dostępni.
• Sprawdź, czy jane.doe@google.com jest wolny w poniedziałek rano.

Przykład:

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.

Tworzy wydarzenie w kalendarzu.

Użyj tego narzędzia do zapytań takich jak:

• Utwórz w moim kalendarzu wydarzenie na jutro o 14:00 o nazwie „Spotkanie z Jankiem”.
• Zaplanuj spotkanie z john.doe@google.com w przyszły poniedziałek od 10:00 do 11:00.

Przykład:

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'.

Aktualizuje wydarzenie w kalendarzu.

Użyj tego narzędzia do zapytań takich jak:

• Zaktualizuj wydarzenie „Spotkanie z Jankiem” tak, aby odbyło się godzinę później.
• Dodaj john.doe@google.com do spotkania jutro.

Przykład:

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'.

Usuwa wydarzenie z kalendarza.

Użyj tego narzędzia do zapytań takich jak:

• Usuń z mojego kalendarza wydarzenie o identyfikatorze event123.

Aby anulować wydarzenie lub odrzucić zaproszenie na nie, użyj narzędzia respond_to_event.

Przykład:

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

Odpowiada na wydarzenie.

Użyj tego narzędzia do zapytań takich jak:

• Zaakceptuj wydarzenie o identyfikatorze event123 w moim kalendarzu.
• Odrzuć spotkanie z Jankiem.
• Anuluj moje następne spotkanie.
• Wstępnie zaakceptuj spotkanie planistyczne.

Przykład:

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