17. 일정과 할 일을 연결하며 정한 기준

17. 일정과 할 일을 연결하며 정한 기준

데이터에서 시간과 행동으로

지난 제작 회고에서는 Gmail, Sheets, Drive를 다뤘습니다. 메일을 읽고, 표를 가져오고, 파일을 찾는 도구를 AI와 만들면서 결과를 고친 이야기였습니다.

이번에는 Calendar와 Tasks입니다. Calendar에서는 언제 무엇을 할지, Tasks에서는 무엇을 해야 하는지를 다룹니다.

만드는 방식은 같았습니다. 필요한 일을 설명하고, AI가 구현한 결과를 써보고, 제 업무에 맞지 않는 부분을 고쳤습니다. 하지만 정해야 할 것은 달랐습니다. 어떤 시간을 기록할지, 어느 캘린더를 볼지, 어디에서 할 일을 완료할지 같은 기준이었습니다.

이 글도 당시 제작 과정의 회고입니다. 지금은 gws로 연결해 사용할 수 있으니, Calendar와 Tasks용 프로그램을 처음부터 다시 만들 필요는 없습니다. 당시 제가 무엇을 보고 고쳤는지 살펴보겠습니다.

Calendar — 제목과 시간은 다른 정보였습니다

처음에는 일정 확인과 등록이 필요하다고 이야기했습니다. 기간별 조회나 캘린더 목록도 대화하면서 추가했습니다. AI가 SKILL.md와 gcal.py를 만들었습니다. 지침과 실행 프로그램을 나눴던 당시 구성입니다.

써보니 일정 제목에 날짜가 함께 들어갔습니다. 캘린더에는 날짜와 시간이 이미 보이는데, 제목에서도 같은 정보를 읽게 된 겁니다.

그래서 이렇게 고쳤습니다.

일정 등록할 때 제목에 날짜와 시간을 넣지 않게 해줘.
‘2월 18일 미팅’이 아니라 ‘미팅’만 제목으로.
날짜와 시간은 별도로 받아야 해.

날짜를 제목에 쓰면 안 된다는 Google의 규칙이 있는 것은 아닙니다. 제가 일정을 보기 편하게 정한 기준입니다.

내부에서도 제목과 시간은 다른 항목입니다. 아래는 Google Calendar의 이벤트 필드를 따라 만든 가상의 입력 예시입니다. 실제 등록한 일정이 아닙니다.

{
  "summary": "담당자 미팅",
  "start": {
    "dateTime": "2026-11-02T10:00:00+09:00"
  },
  "end": {
    "dateTime": "2026-11-02T11:00:00+09:00"
  }
}

summary는 제목, start와 end는 시작과 끝입니다. dateTime 안의 +09:00은 시간대의 차이를 나타냅니다. 이 예시는 한국 시간으로 오전 10시부터 11시까지의 일정입니다.

‘한 시간 늦춰줘’라면 제목을 고치는 것이 아니라 시작과 끝을 옮겨야 합니다. ‘미팅 이름을 바꿔줘’는 제목을 고치는 일이고요. 같은 일정 수정이어도 바꿀 정보가 다릅니다. Calendar 이벤트 형식

사람이 이 JSON을 직접 작성할 필요는 없습니다. AI가 어떤 값을 넣었는지 설명받고, 요청한 시간과 제목이 맞는지 확인할 수 있으면 됩니다.

어느 캘린더를 보는지도 정했습니다

두 번째로 고친 것은 캘린더 구분이었습니다.

저는 일반 일정과 금융 알림을 나눠 썼습니다. 카페를 운영하다 보면 대출 상환일과 카드 결제일도 놓치면 안 됩니다. 그런데 미팅 일정과 같은 방식으로만 보면 필요한 알림을 구별하기 어렵습니다.

Money 캘린더의 대출 상환일과 카드 결제일을 별도로 가져올 수 있게 해줘.
특정 캘린더를 골라 조회할 수 있도록.

이건 API 기능을 하나 더 넣는 것처럼 보이지만, 시작은 제 업무의 사정이었습니다. ‘오늘 미팅이 뭐지?’와 ‘오늘 빠져나갈 돈이 있나?’는 서로 다른 질문이니까요.

Calendar API에서 일정을 조회할 때는 대상 calendarId와 조회할 기간을 지정합니다. ‘오늘 일정’이라고 했더라도 기본 캘린더만 봤다면 Money 캘린더까지 확인한 것은 아닙니다. 일정 조회의 대상과 조건

AI가 표시 이름으로 캘린더를 찾게 할 수 있지만, 실제로 어느 계정의 어느 캘린더를 골랐는지 확인해야 합니다. 기간과 시간대도 맞아야 하고요.

제가 만든 하루 기록 기능은 이렇게 구분한 일정을 오늘 기록에 넣어 사용했습니다. 기본 Claude Code에 그 기능이 들어 있다는 뜻은 아닙니다. 어떤 캘린더의 어떤 정보를 하루 준비에 쓸지 제가 정하고 구성한 것입니다.

Tasks — 적는 곳과 보는 곳을 나눴습니다

할 일에서는 다른 문제가 있었습니다.

포스트잇, 메모 앱, 카톡 나에게 보내기. 적을 곳이 여러 군데였습니다. 매장에 포스트잇을 붙여놓고 다음 날 잊어버린 적도 있었습니다. 어디에 적었는지 찾는 게 또 일이었습니다.

그래서 이렇게 시작했습니다.

터미널에서 추가한 할 일을 Google Tasks에서도 확인하고 싶어.

AI가 물었습니다. 양방향으로 맞출 것인지, 한쪽에서 다른 쪽으로 보낼 것인지. 우선순위 구분도 필요한지.

제가 원했던 것은 컴퓨터에서 할 일을 넣고, 밖에서는 휴대폰으로 보는 방식이었습니다. 로컬 파일을 원본으로 두고 Tasks에 보내는 쪽으로 만들었습니다.

적는 곳 하나, 보는 곳 하나. 이게 제 선택이었습니다.

처음 만든 뒤에는 중복 문제도 고쳤습니다.

동기화할 때 이미 있는 항목은 건너뛰게 해줘.
같은 할 일이 계속 추가되지 않도록.

조회 기능만 있으면 되는 도구와 달리, 동기화는 두 곳의 상태를 맞추는 일이었습니다.

입력과 조회, 완료는 같은 일이 아닙니다

여기서 한 가지를 더 봐야 합니다. 폰에 할 일이 보이는 것과, 폰에서 끝냈다고 표시한 내용이 원본에도 반영되는 것은 다릅니다.

다음은 그 차이를 보여주는 개념도입니다. 실제 API 요청이나 동기화 실행 결과가 아닙니다.

컴퓨터의 원본: 아직 안 한 일
  → Tasks에 보낼 사본: 아직 안 한 일
  → 폰에서 확인

폰에서 완료 표시
  → Tasks 상태는 완료
  → 컴퓨터의 원본도 완료로 바뀌었는가?

Tasks에는 미완료를 뜻하는 needsAction과 완료를 뜻하는 completed 상태가 있습니다. 하지만 그 값을 바꿨다고 제 컴퓨터의 할 일 파일까지 자동으로 바뀌는 것은 아닙니다. 둘을 연결하는 동작이 있어야 합니다. Tasks의 상태 정보

제 현재 전역 할 일 도구에도 Google Tasks에 보내는 구현은 있습니다. 다만 로컬을 원본으로 삼고 보내는 구조에서, 폰의 완료를 로컬에 되돌려 쓰는 경로는 별도입니다. 로컬에는 미완료가 남아 있는데 폰에서만 완료했다면 다음 동기화에서 다시 추가될 수도 있습니다. 연결 코드가 있다는 것만으로 최근의 모든 상태 반영까지 잘됐다고 볼 수는 없습니다.

같은 ‘todo’라는 이름이어도 환경마다 구성은 다릅니다. 제가 캠프에 구성한 로컬 할 일 관리와 Google Tasks까지 연결한 개인 환경도 구별해야 합니다. 공개 독자가 그 도구를 이미 가지고 있다고 가정하는 것은 아닙니다.

자기 방식으로 만들 때는 세 가지를 먼저 이야기하면 좋습니다.

  • 입력: 어디에서 새 할 일을 추가할 것인가?
  • 조회: 어디에서 목록을 볼 것인가?
  • 완료: 어디에서 끝났다고 표시하고, 어느 쪽 상태를 원본으로 삼을 것인가?

폰에서 확인만 하면 되는 분과 폰에서 추가하고 완료까지 해야 하는 분은 필요한 구성이 다릅니다. ‘동기화해줘’라는 한마디 안에 이 선택들이 들어 있습니다.

지금 만든다면 무엇을 맡길까요?

이미 gws로 일정과 Tasks 기능을 호출할 수 있다면, 같은 호출을 하는 Python 프로그램부터 다시 만들 필요는 없습니다. 먼저 실제 업무에서 무엇이 불편한지 보고 그 부분을 맞추면 됩니다.

예를 들어 일정 조회는 이렇게 요청할 수 있습니다. 읽기 연결을 마친 뒤 자기 계정에서 확인할 때의 요청 예시입니다.

내가 볼 수 있는 캘린더에서 일정용과 금융 알림용을 구별해보고 싶어.
대상 캘린더를 확인하고, 오늘 자료를 어떤 기준으로 나눠 보여주면 좋을지 제안해줘.
일정을 새로 만들거나 수정하지는 마.

단순히 두 목록을 보여주는 것에서 끝내지 않고, 어느 캘린더를 봤는지와 필요한 알림이 빠지지 않았는지 확인합니다. 마음에 드는 방식이 나오면 다음에도 같은 기준으로 정리하게 할 수 있습니다.

반대로 ‘다음 주 월요일 오전 10시에 일정을 넣어줘’, ‘Tasks에 새 할 일을 추가해줘’는 실제 데이터를 바꾸는 일입니다. 앞의 연결 안내에서 읽기만 허용했다면 그대로 실행할 수 있는 범위가 아닙니다. 필요한 서비스와 쓰기 권한, 실제 대상부터 따로 확인해야 합니다.

스킬 지침에 적었다고 없는 연결 권한이 생기지는 않습니다. 어떤 정보를 확인하고 어떻게 보여줄지는 지침이, 실제 서비스 호출은 연결 도구가 맡는다고 구별하면 됩니다.

도구를 만들며 제가 정한 것

Calendar에서는 제목과 시간을 나눴습니다. 일반 일정과 금융 알림도 나눴습니다. Tasks에서는 적는 곳과 보는 곳을 정했고, 중복 추가를 막도록 고쳤습니다.

코드를 직접 쓰지는 않았습니다. 하지만 원하는 업무를 설명하고, 결과를 보고, 어느 부분이 불편한지 말했습니다. 그 과정에서 기능보다 중요한 선택이 나왔습니다.

무엇을 같은 것으로 보고, 무엇을 나누고, 어디의 상태를 믿을 것인가. 이런 기준은 제 일의 방식에서 나옵니다. AI가 구현을 맡아도 제가 판단해야 할 부분입니다.

Google 연결이 먼저 필요한 분은 현재 연결 안내인 18편을 보면 됩니다. 이 회고의 당시 자체 인증 모듈을 다시 만드는 과정은 필요하지 않습니다.

다음으로는 만족한 업무 방식을 다시 쓰는 방법을 보겠습니다. 12편 스킬 개념에서 이어 읽을 수 있습니다. 이 제작 회고는 선택 경로이고, 기본 학습 순서는 외부 연결 다음에 스킬입니다.

Subscribe to 비개발자를 위한 Claude Code | 일을 잘하기 위한 AI Workspace

Don’t miss out on the latest issues. Sign up now to get access to the library of members-only issues.
[email protected]
Subscribe