MCP Reference: calendarmcp.googleapis.com

Model Context Protocol (MCP) sunucusu, Büyük Dil Modeli'ne (LLM) veya yapay zeka uygulamasına bağlam, veri ya da özellikler sağlayan harici bir hizmet ile bu hizmeti kullanan uygulama arasında proxy görevi görür. MCP sunucuları, yapay zeka uygulamalarını veritabanları ve web hizmetleri gibi harici sistemlere bağlar ve yanıtlarını yapay zeka uygulamasının anlayabileceği bir biçime çevirir.

MCP Araçları

MCP aracı, bir MCP sunucusunun gerçek dünyada işlem yapmak için bir LLM'ye veya yapay zeka uygulamasına sunduğu bir işlev ya da yürütülebilir özelliktir.

calendarmcp.googleapis.com MCP sunucusunda aşağıdaki araçlar bulunur:

MCP Araçları
list_events

Belirli bir takvimdeki, belirli koşulları karşılayan takvim etkinliklerini listeler.

Temel Özellikler:

  • Kullanıcının birincil takvimi veya diğer takvimler olabilen herhangi bir takvim kimliği.
  • Anahtar kelime eşleme.
  • Zaman aralığına göre filtreleme.
  • Zaman ve anahtar kelime kısıtlamalarıyla eşleşen TÜM etkinlikleri alır.

Aşağıdaki durumlarda bunun yerine search_events aracını kullanın:

  • Kısıtlamaları karşılayan tüm etkinlikleri değil, en alakalı (en üstteki K) etkinlikleri bulmanız gerekir.
  • Semantik arama özelliklerine ihtiyacınız var.
  • Yalnızca kullanıcının birincil takviminde belirli bilgileri arıyorsunuz.

Bu aracı aşağıdaki gibi sorgular için kullanın:

  • Yarın takvimimde ne var?
  • 14 Temmuz 2025'te takvimimde ne var?
  • Gelecek hafta hangi toplantılarım var?
  • Bu öğleden sonra çakışan toplantım var mı?

Örnek:

list_events(
    start_time='2024-09-17T06:00:00',
    end_time='2024-09-17T12:00:00',
    page_size=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.
get_event

Belirli bir takvimdeki tek bir etkinliği döndürür.

Bu aracı aşağıdaki gibi sorgular için kullanın:

  • Ekip toplantısının ayrıntılarını alma
  • Takvimimde event123 kimlikli etkinliği göster.

Örnek:

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

Kullanıcının takvim listesindeki takvimleri döndürür.

Bu aracı aşağıdaki gibi sorgular için kullanın:

  • Tüm takvimlerim neler?

Örnek:

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

Bir veya daha fazla takvimde zaman aralıkları önerir. Birincil takvime erişmek için katılımcı_e-postaları alanına "primary" değerini ekleyin.

Bu aracı aşağıdaki gibi sorgular için kullanın:

  • Toplantı için ne zaman müsait olursunuz?
  • İkimizin de müsait olduğu 30 dakikalık bir zaman aralığı bul.
  • jane.doe@google.com adresinin pazartesi sabahı müsait olup olmadığını kontrol edin.

Örnek:

suggest_time(
    attendee_emails=['joedoe@gmail.com', 'janedoe@gmail.com'],
    start_time='2024-09-10T00:00:00',
    end_time='2024-09-17T00:00:00',
    duration_minutes=60,
    preferences={
        'start_hour': '09:00',
        'end_hour': '17:00',
        'exclude_weekends': 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.
create_event

Takvim etkinliği oluşturur.

Bu aracı aşağıdaki gibi sorgular için kullanın:

  • Yarın saat 14:00 için takvimimde "Ayşe ile toplantı" adlı bir etkinlik oluştur.
  • Gelecek pazartesi günü john.doe@google.com ile 10:00-11:00 arasında toplantı planla.

Örnek:

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

Takvim etkinliğini günceller.

Bu aracı aşağıdaki gibi sorgular için kullanın:

  • "Jane ile toplantı" etkinliğini bir saat sonraya erteleyin.
  • Yarınki toplantıya john.doe@google.com adresini ekle.

Örnek:

update_event(
    event_id='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'.
delete_event

Takvim etkinliğini siler.

Bu aracı aşağıdaki gibi sorgular için kullanın:

  • Takvimimde etkinlik123 kimlikli etkinliği sil.

Bir etkinliği iptal etmek veya reddetmek için bunun yerine respond_to_event aracını kullanın.

Örnek:

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

Etkinliğe yanıt verir.

Bu aracı aşağıdaki gibi sorgular için kullanın:

  • Takvimimde event123 kimlikli etkinliği kabul et.
  • Ayşe ile toplantıyı reddet.
  • Bir sonraki toplantımı iptal et.
  • Planlama toplantısını geçici olarak kabul edin.

Örnek:

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

MCP aracı özelliklerini alma

Bir MCP sunucusundaki tüm araçlar için MCP aracı özelliklerini almak üzere tools/list yöntemini kullanın. Aşağıdaki örnekte, MCP sunucusunda şu anda kullanılabilen tüm araçları ve özelliklerini listelemek için curl komutunun nasıl kullanılacağı gösterilmektedir.

Curl İsteği 
curl --location 'https://calendarmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'