これは、Google Calendar API によって提供される MCP サーバーです。サーバーには、カレンダーの上に LLM アプリケーションを構築するためのツールが用意されています。
Model Context Protocol（MCP）サーバーは、大規模言語モデル（LLM）または AI アプリケーションにコンテキスト、データ、機能を提供する外部サービスとの間のプロキシとして機能します。MCP サーバーは、AI アプリケーションをデータベースやウェブサービスなどの外部システムに接続し、そのレスポンスを AI アプリケーションが理解できる形式に変換します。
サーバーのセットアップ
使用する前に、カレンダー MCP サーバーを構成する必要があります。Google と Google Cloud のリモート MCP サーバーの使用方法については、Google Cloud MCP サーバーの概要をご覧ください。
サーバー エンドポイント
MCP サービス エンドポイントは、安全で標準化された接続を確立するために AI アプリケーション（MCP クライアントのホスト）が使用する MCP サーバーのネットワーク アドレスと通信インターフェース（通常は URL）です。これは、LLM がコンテキストをリクエストしたり、ツールを呼び出したり、リソースにアクセスしたりするための接続ポイントとなります。Google MCP エンドポイントをグローバルまたはリージョンにすることができます。
カレンダー 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（メール識別子）に解決します。 |
suggest_time |
1 つ以上のカレンダーで期間を提案します。 |
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 }' |