MCP Reference: calendarmcp.googleapis.com

這是 Google Calendar 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 MCP API 具有下列全域 MCP 端點:

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

MCP 工具

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

工具

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

MCP 工具
list_events 傳回指定日曆中符合所有指定限制的活動。除非使用者要求,否則請勿指定時間限制。如要在主要日曆中進行開放式關鍵字或主題式搜尋,請改用 search_events 工具。
get_event 傳回指定日曆上的單一活動。
list_calendars 傳回使用者可存取的日曆 (即日曆清單)。使用這項工具將日曆識別資料 (例如「我的家庭群組日曆」) 解析為對應的 calendar_id (電子郵件 ID)
suggest_time 建議一或多個日曆中的時間範圍。
create_event 在指定日曆中建立活動。
update_event 更新指定日曆中的活動。
delete_event 刪除指定日曆上的活動。
respond_to_event 回覆日曆活動。
search_events 使用語意搜尋功能,在使用者主日曆中搜尋活動。

取得 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
}'