본문으로 건너뛰기

승인형 'Google Calendar-IoT' 일정 비서로 바꾼 개발기

강진태

2026.07.26

## 📝 한 줄 요약

Google Nest의 자유발화를 외부 AI가 직접 받는 공식 경로가 없다는 사실을 확인한 뒤, **Google Assistant 기본 일정 입력 → Hermes 분석 → 충돌 조정 → 사람 승인 → Google Calendar 반영 → Ava 음성으로 Nest 안내**하는 구조로 다시 설계했다. 일정 코어·승인 게이트·Calendar 어댑터·음성 출력·Skill candidate·DEVLOG까지 구현했고 자동 테스트 15개를 통과했지만, 실계정 OAuth가 없어 Calendar부터 Nest까지의 전체 End-to-End는 아직 부분 완료 상태다.

**바쁘시면 이것만 읽어도 돼요:**

- 공식 API로 불가능한 Nest 자유발화 전달은 우회하지 않고 입력·분석·출력 역할을 분리했다.
- 11:00~12:00 기존 회의와 겹친 11:30 요청을 Q1으로 분류하고 12:15~13:15를 제안했다.
- 생성·수정·삭제는 `pending_approval`로 멈추며, 승인 전 Calendar backend 호출은 0회다.
- 구현 규칙을 Use When·Input·Judgment·Steps·Output·Verification·Failure Repair의 7필드 Skill로 만들었다.
- 흩어진 기획·실패·테스트·OAuth 대기를 DEVLOG로 복원했다.
- 서울말 반말의 Ava 음성을 거실 Google Nest Hub에서 실제 재생했다.
- 현재 자동 테스트는 15/15 PASS지만 Google Calendar 실계정 OAuth와 readback은 남아 있다.

## 🎯 이런 분들께 도움돼요

- 비개발자지만 AI와 함께 개인 업무 자동화를 만들고 싶은 사람
- Google Calendar와 스마트 스피커를 안전하게 연결하고 싶은 사람
- AI가 외부 시스템을 바꾸기 전에 사람 승인을 넣고 싶은 PMO
- 공식 API 한계 때문에 프로젝트를 포기할지 고민하는 사람
- 한 번 만든 코드를 반복 가능한 Skill과 사례글로 남기고 싶은 사람

## 😫 문제 상황: “오케이 구글” 한마디로 일정 비서를 부르고 싶었다

처음 목표는 집 안의 Google Nest Hub와 Home Mini를 일정 비서의 입구와 출구로 쓰는 것이었다. “오케이 구글”이라고 부른 뒤 일정을 말하면 AI가 중요도와 긴급도를 판단하고, 기존 일정과 겹치면 대안을 제안하고, 승인하면 Google Calendar에 반영한 뒤 음성으로 결과를 알려주는 경험을 원했다.

```text
구글캘린더와 연결하여 일정들을 관리하고, 집에 있는 구글허브와 구글미니에서 음성으로 일정에 대한 내용을 확인하고 듣고 싶다. 일정 요청은 에이전트가 직접 받아 아이젠하워 매트릭스 등을 활용하여 조정하고 싶다.
```

아이디어는 단순해 보였지만 실제로는 여섯 가지 과제가 연결돼 있었다.

1. Nest 자유발화가 외부 AI로 전달되는가
2. 일정 요청을 어떤 기준으로 판단할 것인가
3. AI가 실제 일정을 마음대로 바꾸지 않게 하려면 어떻게 할 것인가
4. 구현 규칙을 다시 쓸 수 있는 Skill로 만들 수 있는가
5. 여러 대화와 실행 기록을 사례글 근거로 어떻게 복원할 것인가
6. 실제 Google Calendar와 Nest까지 End-to-End로 연결됐는가

이번 글은 대시보드의 3·5·6·11·13·15번을 이 여섯 질문의 답으로 연결한 기록이다.

## 🛠️ 사용한 도구

- **Hermes Agent:** 과거 대화 복원, 공식 문서 조사, 설계, 구현, 실행 검증
- **Python 3.11·unittest:** 일정 분류·충돌·승인·OAuth·Cast 테스트
- **Google Calendar API v3:** 이벤트 조회·생성·수정·삭제 어댑터
- **OAuth 2.0 Desktop App 설계:** 읽기와 이벤트 변경 권한 분리
- **Google Cast·pychromecast:** 정확한 기기 선택과 실제 음원 재생
- **Edge TTS Ava:** 서울말 반말 일정·뉴스 안내 음성
- **W1 기본과제·write-post:** Skill 7필드와 비개발자용 사례글 구조
- **AI-PMO-OS 원칙:** Evidence 우선, AI 제안과 공식 상태 분리, 사람 승인

---

## 🔧 작업 과정

### CASE 3. 자유대화 API가 안 돼도 일정 비서를 살린 재설계

가장 먼저 한 일은 코딩이 아니라 공식 지원 범위를 확인하는 것이었다. Google의 Conversational Actions는 2023년 6월 13일 종료됐고, 현재 Google Home API에는 Nest 마이크의 자유발화 원문을 범용 외부 에이전트로 넘기는 공식 통로가 없었다.

고정 문구를 Google Home 자동화의 시작 조건으로 쓰는 것은 가능하지만, “다음 주 화요일 오후 두 시에 회의 잡아줘”처럼 매번 내용이 달라지는 전체 문장을 Hermes에 전달하는 기능은 아니었다.

처음 기대한 구조는 막혔지만, 사용자 경험의 목적까지 포기할 필요는 없었다. 입력과 분석, 승인을 분리해 다음과 같이 다시 설계했다.

```text
Google Assistant 기본 Calendar 입력
→ Hermes가 Calendar 이벤트 조회
→ 아이젠하워 분류·충돌 검사
→ 조정안 제안
→ 사용자 승인
→ Google Calendar 반영·재조회
→ 선택한 Nest에서 음성 안내
```

Google Assistant는 이미 잘하는 일정 입력을 담당하고, Hermes는 판단과 조정, 사용자는 최종 승인, Nest는 결과 안내를 담당한다. 지원하지 않는 마이크 우회나 음성 몰래 수집은 명시적으로 제외했다.

이 단계에서 `거실` Google Nest Hub와 `침실` Google Home Mini가 로컬 네트워크에서 실제 발견되는 것까지 확인했다. “가능성 검토”가 추상적인 설계 문서에서 끝나지 않고, 사용할 출력 기기까지 식별된 셈이다.

---

### CASE 5. 겹치는 일정을 덮어쓰지 않고 12시 15분을 제안한 코어

다음 과제는 “AI가 일정을 분류한다”는 말을 재현 가능한 결과로 바꾸는 일이었다. 일정 코어는 중요도와 24시간 내 마감 여부를 기준으로 아이젠하워 Q1~Q4를 분류한다.

- Q1: 중요하고 긴급함 → 즉시 처리
- Q2: 중요하지만 덜 긴급함 → 집중 시간으로 예약
- Q3: 긴급하지만 덜 중요함 → 위임 또는 묶음 처리 검토
- Q4: 둘 다 아님 → 제거 또는 보류 검토

하지만 분류만 잘해도 기존 약속을 덮어쓰면 쓸 수 없다. 그래서 민감정보가 없는 가상 일정으로 충돌 수리 시나리오를 만들었다.

- 현재 시각: 오전 9시
- 기존 일정: 11:00~12:00 기존 주간회의
- 새 요청: 11:30 시작, 60분, 제안서 최종 검토
- 중요도: 중요
- 마감: 8시간 뒤

실제 시뮬레이션 결과는 다음과 같았다.

```text
분류: Q1
충돌: 기존 주간회의 1건
제안 시간: 12:15~13:15
상태: pending_approval
실제 반영: false
```

새 요청은 기존 회의와 겹쳤고, 코어는 기존 회의 종료 시각인 12시에서 15분의 이동·준비 시간을 더한 12시 15분을 제안했다. 충돌한 이벤트 ID도 함께 남겼다.

첫 실행에서는 파일 경로로 스크립트를 직접 실행해 모듈 import 오류가 났다. 실행 방식을 프로젝트 모듈 기준으로 고친 뒤 동일한 입력을 다시 실행했고, 같은 12:15~13:15 결과를 재현했다. 성공한 결과만 남긴 것이 아니라 실패 원인과 수리 방법까지 기록했다.

---

### CASE 6. AI가 일정 삭제를 마음대로 못 하게 만든 승인 게이트

일정 자동화에서 가장 위험한 순간은 “좋은 제안”이 “즉시 실행”으로 바뀌는 지점이다. 잘못된 판단으로 회의를 이동하거나 삭제하면 실제 사람의 약속에 영향을 준다.

그래서 생성·수정·삭제를 모두 제안과 실행으로 분리했다.

```text
제안 생성
→ pending_approval
→ 대상·Before·After·충돌 근거 표시
→ 사용자 명시적 승인
→ 정확한 Calendar backend 호출
→ readback 검증
```

테스트에서는 세 가지를 핵심으로 확인했다.

1. 승인하지 않은 제안은 예외로 차단되고 backend 호출 목록이 비어 있다.
2. 승인된 생성 제안은 backend를 정확히 한 번 호출한다.
3. 수정과 삭제는 각각 지정된 `event-42`, `event-99`만 대상으로 호출한다.

즉, “AI가 안전하게 행동할 것”이라는 기대가 아니라 **미승인 호출 0회와 정확한 이벤트 ID**라는 검증 가능한 계약으로 바꿨다.

OAuth도 같은 원칙으로 분리했다. 처음 연결에서는 `calendar.readonly`만 사용하고, 실제 생성·수정·삭제를 승인한 뒤에만 `calendar.events`를 별도로 연결하도록 했다. Gmail·Drive를 포함한 넓은 권한이나 Calendar 설정 전체 권한은 요청하지 않는다.

---

### CASE 11. 코드에서 끝내지 않고 7필드 일정관리 Skill candidate로 만들기

기능이 여러 Python 파일과 설명에 흩어져 있으면 다음번에 다시 사용할 때 같은 판단 규칙을 처음부터 설명해야 한다. 그래서 Google Calendar-IoT를 반복 가능한 업무 계약인 Skill candidate로 정리했다.

Skill은 다음 7개 필드로 구성했다.

1. **Use When:** 언제 이 Skill을 사용할지
2. **Input:** 일정 제목·희망 시간·소요시간·중요도·마감
3. **Judgment:** Q1~Q4 분류와 15분 충돌 버퍼
4. **Steps:** OAuth 확인부터 readback과 Cast까지 실행 순서
5. **Output:** 상태·대상·시간·충돌·적용 여부가 포함된 구조
6. **Verification:** 승인·event ID·timezone·readback·기기 확인
7. **Failure Repair:** OAuth 없음, Cast 미발견, 자유발화 불가, 입력 누락, 실행 실패 복구

출력 계약에는 `pending_approval`, `applied:false`, `readback:not_checked`가 기본값으로 들어간다. 실패했을 때 성공으로 꾸미지 않고 `blocked` 또는 승인 대기 상태를 유지하는 규칙도 포함했다.

검증 스크립트를 다시 실행한 결과:

- Skill 이름·frontmatter 정상
- Description 길이 55자
- 필수 섹션 7개 모두 존재
- 검증 상태 **PASS**

현재 결과물은 설치 완료 Skill이 아니라 **검증된 candidate**다. “Candidate PASS”와 “기본 프로필 설치 완료”를 구분해 표시했다.

---

### CASE 13. 흩어진 AI 협업 기록을 DEVLOG로 복원하기

기능은 만들어졌지만 작업 과정은 여러 대화와 실행 결과에 흩어져 있었다. 사례글을 쓰려면 최종 코드만이 아니라 “왜 시작했고, 어디서 막혔고, 무엇을 바꿨는지”가 필요했다.

DEVLOG에는 다음 여섯 에피소드를 날짜순으로 복원했다.

1. 사라진 Google Calendar-IoT 기획 복원
2. Google Home/Nest 확장 가능성 검토
3. 테스트 우선 일정 판단 코어 제작
4. 가상 일정 첫 실행과 import 오류 수리
5. 사용자 소유 Skill candidate 제작
6. 최소 권한 OAuth 준비와 대기 상태

사용자의 실제 요청은 코드블록으로, AI가 수행한 작업은 파일과 검증 결과 중심으로 분리했다. 기술 스택과 주요 기능도 함께 정리했다.

이 과정에서 문서 기준선의 작은 문제도 발견했다. 초기 README는 테스트 12개, DEVLOG는 당시 기준 13개를 기록하고 있지만 현재 테스트를 다시 실행한 결과는 15개다. 이번 사례글과 구현 그림에는 실제 최신 실행값인 **15/15 PASS**를 사용하고, 기존 문서 숫자는 다음 정리 때 최신화할 항목으로 남겼다.

---

### CASE 15. 실제 Google Calendar에서 Nest 음성까지 가는 End-to-End 파일럿

마지막 단계는 시뮬레이션을 실제 계정과 기기로 연결하는 일이었다. 구현 목표는 다음과 같다.

```text
실제 Calendar 읽기
→ 일정 분류·충돌 제안
→ 사용자 승인
→ Calendar 반영
→ readback 확인
→ Ava 음성 생성
→ 거실 Nest 1회 재생
```

음성은 여러 후보를 비교했다. 로컬 MeloTTS도 설치해 한국어 모델을 시험했지만 공식 한국어 화자가 한 명뿐이라 서로 다른 음색을 선택하기에는 제한이 있었다. 이후 서로 다른 여성 음성 5개를 같은 서울말 문장으로 비교했고, 최종적으로 **Ava 다국어 여성 음성 + 서울말 반말 + “오빠” 호칭**을 선택했다.

Google Assistant의 시스템 음성 자체를 Ava로 교체할 수는 없다. 대신 Hermes가 만드는 일정·뉴스·사용자 지정 안내만 Ava 음원으로 생성해 Nest에 Cast하는 구조로 범위를 명확히 했다.

실제 거실 Nest 재생에서는 다음 Evidence를 확인했다.

- `거실`과 `침실` 기기 발견
- 정확한 대상 `거실` 1대 선택
- Nest의 음원 요청 `HTTP 200`
- 재생 시작 `PLAYING` 또는 `BUFFERING`
- 최종 상태 `FINISHED`
- 침실로의 임의 fallback 없음

한 번은 네트워크 탐색에서 침실만 보이고 거실이 발견되지 않았다. 이때 침실로 바꿔 재생하지 않고 안전하게 중단했다. 이후 탐색 시간을 늘려 거실을 다시 발견한 뒤 정상 재생했다. 이 실패는 “목표 기기를 못 찾으면 다른 기기로 재생하지 않는다”는 안전 규칙을 실제로 보여줬다.

그러나 Google Calendar 실계정 연결은 아직 완료되지 않았다. 현재 정확한 OAuth 기본 경로에서 확인한 결과는 다음과 같다.

- Desktop client secret: 없음
- 읽기 전용 token: 없음
- 이벤트 변경 token: 없음

따라서 현재 상태는 **Nest 음성 출력 실재생 완료 / Calendar 실계정 End-to-End 미완료**다. 음성이 나왔다는 이유만으로 전체 연결이 완성됐다고 표현하지 않았다.

---

## ✅ 결과

### Before vs After

| 영역 | Before | 현재 결과 |
|---|---|---|
| 제품 구상 | Nest 자유발화를 외부 AI가 직접 수신 | 기본 Calendar 입력·Hermes 분석·Nest 출력으로 역할 분리 |
| 일정 판단 | 사람이 중요도와 빈 시간을 직접 판단 | Q1~Q4 분류와 충돌 후 15분 버퍼 제안 |
| 안전 | 자동화가 실제 변경으로 직결될 위험 | `pending_approval`과 승인 전 backend 호출 0회 |
| Calendar 연동 | 아이디어 단계 | CRUD 어댑터·OAuth 분리 테스트 완료, 실계정 미연결 |
| 음성 출력 | 가능성만 검토 | Ava 서울말 반말 음성, 거실 Nest 실재생 완료 |
| 재사용성 | 코드와 설명이 여러 파일에 분산 | 필수 7필드 Skill candidate PASS |
| 작업 기록 | 대화와 실행 결과에 흩어짐 | 6개 에피소드 DEVLOG 복원 |
| 자동 검증 | 없음 | unittest 15/15 PASS |
| 전체 E2E | 미구현 | 5개 업무 완료, 1개 부분 완료 |

## 📌 현재 구현 범위

### 구현·검증 완료

- Google Nest 공식 지원 경계에 맞춘 대안 구조
- Q1~Q4 아이젠하워 분류
- 일정 충돌 감지와 15분 버퍼 제안
- 생성·수정·삭제 승인 게이트
- Calendar CRUD 어댑터와 timezone 처리
- 읽기·쓰기 OAuth scope와 token 분리 설계
- 한국어 일정 브리핑 생성
- 정확한 Cast 기기 선택과 실패 시 안전 중단
- Ava 서울말 반말 음성 생성
- 거실 Google Nest Hub 실제 재생
- 7필드 Skill candidate와 DEVLOG
- 자동 테스트 15/15

### 아직 남은 것

- Google Cloud Desktop OAuth JSON 준비
- `calendar.readonly` 실계정 연결
- 실제 오늘 일정 조회
- 사용자 승인 UI 또는 Telegram 승인 흐름
- 별도 승인 후 `calendar.events` 연결
- 실제 이벤트 1건 생성·수정·readback
- Calendar→Hermes→승인→Nest 전체 End-to-End
- 중복 이벤트 처리와 운영 모니터링

## 💬 이 과정에서 배운 AI 활용 팁

### 효과적이었던 것

1. **코딩 전에 공식 지원 경계를 확인했다.**  
   종료된 API를 전제로 구현하는 재작업을 막았다.
2. **사용자 경험의 목적과 기술 수단을 분리했다.**  
   자유발화 전달은 불가능했지만 안전한 일정 비서 경험은 살렸다.
3. **좋은 행동보다 금지 행동을 먼저 테스트했다.**  
   승인 전 호출 0회, 정확한 기기 일치, 임의 fallback 금지가 핵심이었다.
4. **시뮬레이션·adapter 테스트·실재생을 구분했다.**  
   각 결과가 무엇을 증명하고 무엇을 증명하지 못하는지 명확해졌다.
5. **실패를 Failure Repair로 남겼다.**  
   import 오류, Cast 탐색 누락, OAuth 부재가 다음 실행의 복구 절차가 됐다.
6. **코드·Skill·DEVLOG·사례글을 하나의 Evidence 체인으로 연결했다.**

### 이렇게 하면 안 돼요

1. Nest 마이크를 비공식 방식으로 우회하거나 몰래 수집하지 않는다.
2. 중요도·마감·대상 이벤트가 불명확한데 AI가 추측해 실행하지 않는다.
3. 승인 전 생성·수정·삭제를 수행하지 않는다.
4. Cast 목표 기기를 못 찾았을 때 다른 방의 기기로 대체 재생하지 않는다.
5. Nest 음성 재생 성공을 Calendar 전체 End-to-End 완료로 과장하지 않는다.
6. Candidate 검증 통과를 설치·운영 완료로 표현하지 않는다.


3

함께 이야기해요 3

로그인하고 댓글을 남겨 주세요

Giacomo 프로필 이미지
Giacomo2026.07.28

Nest 자유발화를 비공식으로 우회하지 않고, 기본 일정 입력·Hermes의 판단·사람 승인·Nest 출력으로 역할을 다시 나눈 선택이 좋았어요. 승인 전 backend 호출 0회, 정확한 이벤트 ID와 목표 기기만 허용하고 거실 기기를 못 찾았을 때 침실로 대체하지 않은 점까지 안전 규칙을 실행 가능한 계약으로 만든 과정이 인상적이었습니다.

15개 자동 테스트와 거실 Nest 음성 재생은 분명한 증거지만, Calendar 실계정 OAuth와 이벤트 readback이 없어 전체 End-to-End는 아직 미완료라는 경계도 잘 지키셨습니다. 다음에는 최소 권한의 비민감 테스트 캘린더에서 조회부터 명시적 승인, 이벤트 1건 반영, 재조회까지 수행하고 각 단계의 대상 ID와 적용 여부를 남기면 부분 완료와 전체 연결의 차이가 더 선명해질 것 같아요.

유피테르 프로필 이미지
유피테르2026.07.28

거실 Nest가 보이지 않았을 때 침실 기기로 임의 대체하지 않고 중단한 뒤, 탐색 시간을 늘려 정확한 대상에서 재생을 확인하신 과정이 특히 인상적이었습니다. 목표 기기 1대 선택부터 HTTP 200, PLAYING/BUFFERING, FINISHED까지 증거를 남긴 덕분에 ‘작동했다’는 결과가 훨씬 신뢰감 있게 다가왔어요. Nest 실재생과 아직 남은 Calendar OAuth 작업을 분명히 구분해 기록하신 점에서도 구현 범위를 과장하지 않는 꼼꼼함이 느껴졌습니다.

자연어회계처리 프로필 이미지

와, Google Nest 자유발화가 막혔을 때 포기하지 않고 입력과 분석, 출력을 쪼개서 재설계하신 건 진짜 생각지도 못한 유연한 해결책이네요. 강진태님의 글을 읽으면서 기술적 한계에 부딪혔을 때 설계를 어떻게 구조적으로 비틀어야 하는지 좋은 힌트를 얻었습니다. 특히 마음대로 일정을 바꾸지 않게 승인 전까지 API 호출을 0회로 묶어둔 안전장치 디테일에 감탄이 절로 나왔습니다. 막히는 구현 과정을 이렇게 생생한 기록으로 공유해주셔서 정말 큰 자극이 되었습니다.

필요한 AI 정보만
메일함에 쏙쏙 넣어드려요.

지금 핫한 AI 소식부터 직접 해 본 사례까지, 월요일마다 무료로 받아보세요