MCP Reference: calendarmcp.googleapis.com

這是 Google 日曆 API 提供的 MCP 伺服器。伺服器提供工具，供開發人員在 Google 日曆上建構 LLM 應用程式。

Model Context Protocol (MCP) 伺服器可做為代理伺服器，在外部服務與大型語言模型 (LLM) 或 AI 應用程式之間傳輸脈絡、資料或功能。MCP 伺服器可將 AI 應用程式連結至資料庫和 Web 服務等外部系統，並將系統回覆轉換成 AI 應用程式可理解的格式。

伺服器設定

您必須先設定 Calendar MCP 伺服器，才能使用這項功能。如要進一步瞭解如何使用 Google 和 Google Cloud 遠端 MCP 伺服器，請參閱「Google Cloud MCP 伺服器總覽」。

伺服器端點

MCP 服務端點是 MCP 伺服器的網路位址和通訊介面 (通常是網址)，AI 應用程式 (MCP 用戶端的主機) 會使用這個端點建立安全標準連線。這是 LLM 請求內容、呼叫工具或存取資源的聯絡點。Google MCP 端點可以是全域或區域。

Calendar API MCP 伺服器具有下列全域 MCP 端點：

  • https://calendarmcp.googleapis.com/mcp/v1

MCP 工具

MCP 工具是 MCP 伺服器向 LLM 或 AI 應用程式公開的函式或可執行功能，可在現實世界中執行動作。

工具

calendarmcp.googleapis.com MCP 伺服器提供下列工具：

MCP 工具
list_events

Lists calendar events in a given calendar satisfying the given conditions.

主要功能與特色：

  • 任何日曆 ID，可以是使用者的主要日曆或其他日曆。
  • 關鍵字比對。
  • 時間範圍篩選。
  • 擷取符合時間和關鍵字限制的所有事件。

在下列情況下，請改用 search_events 工具：

  • 您需要找出最相關的 (前 K 個) 事件，而不是滿足限制條件的所有事件。
  • 您需要語意搜尋功能。
  • 您只在搜尋使用者主要日曆中的特定資訊。

這項工具適用於以下查詢：

  • 明天日曆上有什麼活動？
  • 2025 年 7 月 14 日的日曆上有哪些活動？
  • 我下週有哪些會議？
  • 我今天下午有任何會議衝突嗎？

範例：

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

從指定日曆傳回單一活動。

這項工具適用於以下查詢：

  • 取得團隊會議的詳細資料。
  • Show me the event with id event123 on my calendar.

範例：

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

傳回使用者日曆清單中的日曆。

這項工具適用於以下查詢：

  • 我有哪些日曆？

範例：

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

建議一或多個日曆中的時間範圍。如要存取主要日曆，請在 attendee_emails 欄位中新增「primary」。

這項工具適用於以下查詢：

  • 我們何時都有空開會？
  • 找出我們兩人都有空的 30 分鐘時段。
  • 確認 jane.doe@google.com 週一上午是否有空。

範例：

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

建立日曆活動。

這項工具適用於以下查詢：

  • 在我的日曆中新增一個明天下午 2 點的活動，取名為「與 Jane 會議」。
  • 安排下週一上午 10 點到 11 點與 john.doe@google.com 開會。

範例：

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

更新日曆活動。

這項工具適用於以下查詢：

  • 將「與 Jane 會議」活動延後一小時。
  • 明天在會議中加入 john.doe@google.com。

範例：

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

刪除日曆活動。

這項工具適用於以下查詢：

  • 刪除我日曆上 ID 為 event123 的活動。

如要取消或拒絕活動，請改用 respond_to_event 工具。

範例：

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

回覆活動。

這項工具適用於以下查詢：

  • 接受日曆上 ID 為 event123 的活動。
  • 拒絕與小珍的會議。
  • 取消下一場會議。
  • 暫時接受規劃會議邀請。

範例：

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

取得 MCP 工具規格

如要取得 MCP 伺服器中所有工具的 MCP 工具規格，請使用 tools/list 方法。以下範例說明如何使用 curl 列出 MCP 伺服器中目前可用的所有工具及其規格。

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