> For the complete documentation index, see [llms.txt](https://docs.wrks.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.wrks.ai/user-guide/undefined-1/google-calendar.md).

# Google Calendar

에이전트에 Google Calendar 도구를 연결하면 대화만으로 일정을 조회하고, 새 일정을 만들고, 기존 일정을 수정할 수 있어요. 결과는 실제 Google Calendar에 그대로 반영되며, 모든 작업 결과에 일정 링크가 함께 제공됩니다.

### 개요

에이전트와의 대화만으로 일정 조회부터 생성·수정까지 처리할 수 있습니다. 핵심 기능은 **일정 조회 / 일정 생성 / 일정 수정 / 캘린더 목록 조회** 네 가지예요.

![Google Calendar 도구 가이드 — 4가지 핵심 기능 소개](https://deck.onpod.ai/d/9gHLLt/p/4.jpg)

대화 한 문장이면 충분하고, 모든 결과에는 실제 일정 링크가 함께 제공됩니다. 다른 도구와 연계해 일정 확인 후 Notion 정리, 일정 공유 메일 초안 작성까지 한 문장으로 이어갈 수도 있어요.

![Google Calendar로 할 수 있는 것 — 조회·생성·수정·목록·연계·결과 확인](https://deck.onpod.ai/d/9gHLLt/p/5.jpg)

{% hint style="info" %}
도구는 **에이전트 만들기 화면**에서 연결합니다. Google Calendar를 연결한 에이전트에게 말을 걸어보세요.
{% endhint %}

### 일정 조회

원하는 기간의 일정을 말로 물어보면 목록으로 정리해 줍니다.

> "이번 주 일정 보여줘"
>
> "다음주 화요일부터 주간 일정 알려줘"
>
> "내일 일정 있어?"
>
> "3월 10일\~15일 사이에 비어있는 시간 알려줘"

조회 결과에는 일정 제목·시간과 함께 Google Calendar 링크가 표시되어 바로 열어볼 수 있습니다.

![일정 조회 — 웍스AI 대화 결과와 실제 Google Calendar 화면](https://deck.onpod.ai/d/9gHLLt/p/6.jpg)

### 일정 생성

제목, 날짜, 시간을 말하면 새 일정이 바로 등록됩니다.

> "3월 14일 오후 3시\~4시에 '테스트 회의' 일정 등록해줘"
>
> "내일 오전 10시\~11시에 '팀 미팅' 잡아줘"

제목과 날짜, 시작\~종료 시간을 함께 말하면 되묻지 않고 한 번에 정확히 등록됩니다.

![일정 생성 — '테스트 회의' 등록 완료와 실제 캘린더 반영 모습](https://deck.onpod.ai/d/9gHLLt/p/7.jpg)

#### 장소 포함 일정 생성

장소를 함께 입력하면 실제 일정에 장소 정보가 자동으로 추가됩니다.

> "3월 20일 오후 2시\~3시에 '고객 미팅' 잡아줘. 장소: 본사 3층 회의실"
>
> "다음 주 수요일 오전 10시\~11시에 '외부 미팅' 등록해줘. 장소: 웍스AI 빌딩"

"장소: 본사 3층 회의실"처럼 붙여 말하면 Google Calendar 일정의 장소 필드에 그대로 들어갑니다.

![장소 포함 일정 생성 — 장소 필드가 자동 입력된 모습](https://deck.onpod.ai/d/9gHLLt/p/8.jpg)

### 일정 수정

기존 일정의 시간이나 내용을 말로 변경할 수 있습니다.

> "테스트 회의 일정을 4시\~5시로 옮겨줘"
>
> "내일 팀 미팅 시간을 오전 11시\~12시로 변경해줘"
>
> "고객 미팅 장소를 '본사 5층 대회의실'로 바꿔줘"

일정 이름을 말하고 바꿀 내용을 알려주면 해당 일정을 찾아 수정합니다. 시간·제목·장소 변경을 모두 지원해요.

![일정 수정 — '테스트 회의'를 오후 4시\~5시로 변경한 결과](https://deck.onpod.ai/d/9gHLLt/p/9.jpg)

### 캘린더 목록 조회

> "캘린더 목록 조회해줘"

내 계정으로 접근 가능한 모든 캘린더가 표시됩니다. 여러 캘린더를 함께 쓰는 경우, 에이전트가 어떤 캘린더에 접근할 수 있는지 먼저 확인할 때 유용해요.

![캘린더 목록 조회 — 접근 가능한 캘린더 목록 응답](https://deck.onpod.ai/d/9gHLLt/p/10.jpg)

{% hint style="info" %}
일정 조회·생성 시 "기본 캘린더에서"처럼 캘린더를 지정하면 원하는 캘린더에서 더 정확하게 작동합니다.
{% endhint %}

### 다른 도구와 연계 활용

일정 확인에서 끝내지 않고, Notion 정리와 메일 안내까지 한 문장으로 이어집니다.

> "기본 캘린더에서 이번주 화요일부터 주간 일정 확인하고 Notion MCP TEST 페이지에 정리해줘"
>
> "기본 캘린더에서 내일 일정 확인하고, 김대리한테 일정 공유 메일 초안 작성해줘"

캘린더와 Notion 페이지를 구체적으로 지정하면 더 정확하게 작동하고, 확인한 일정을 바탕으로 공유용 메일 초안까지 한 번에 작성됩니다.

![다른 도구와 연계 활용 — 일정 확인 후 Notion 정리·메일 안내](https://deck.onpod.ai/d/9gHLLt/p/11.jpg)

{% hint style="warning" %}
연계할 도구(Notion, 메일 등)도 에이전트에 함께 연결되어 있어야 합니다. 에이전트 만들기 화면에서 도구를 추가해 두세요.
{% endhint %}

### 활용 팁

1. **시간 범위를 함께 지정하세요** — "오후 3시에 회의 잡아줘"보다 "오후 3시\~4시에 '기획 회의' 등록해줘"처럼 시작\~종료 시간을 함께 말하면 더 정확합니다.
2. **장소도 같이 말하세요** — "장소: 본사 3층 회의실"처럼 함께 입력하면 장소 정보가 자동으로 추가됩니다.
3. **기간을 명확히 하세요** — "이번 주", "다음 주 월\~금", "3월 10일\~15일"처럼 기간을 지정하면 더 정확한 결과를 받습니다.
4. **연계 작업도 가능합니다** — "이번 주 일정 확인하고 Notion에 정리해줘"처럼 다른 도구와 함께 사용할 수 있습니다.

![활용 팁 — 시간 범위·장소·기간 지정과 연계 작업](https://deck.onpod.ai/d/9gHLLt/p/12.jpg)

모든 작업 결과에는 Google Calendar 일정 링크가 함께 제공되어, 등록·변경된 일정을 바로 열어 확인할 수 있습니다.

![일정 관리, 대화로 끝내세요 — 시작해 볼 만한 예시 프롬프트](https://deck.onpod.ai/d/9gHLLt/p/13.jpg)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.wrks.ai/user-guide/undefined-1/google-calendar.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.