📅

Google Calendar MCP 발급 가이드

난이도⭐⭐⭐⭐☆

💡 Google Calendar MCP가 뭐예요?

사용자 앱이 Google Calendar 일정 자동 조회 / 생성 / 수정을 표준 MCP 프로토콜로 처리. AI 비서가 "다음 주 회의 일정 정리해줘" 같은 발화에 자동 응답.

  • ✅ AI 일정 비서 / 회의록 정리 / 자동 일정 생성
  • ✅ 여러 외부 도구 통합 (Notion + Calendar + Slack)
  • ⚠️ OAuth 2.0 흐름 필요 — 다른 MCP보다 설정 복잡

Google OAuth 2.0 설정 (기존 가이드 활용)

Google Calendar MCP 연결도 OAuth 2.0이 필요해요.

이미 설정 했으면 다음 Step으로! Google OAuth 가이드 참조 (Cloud Console 프로젝트 + Calendar API 활성화 + OAuth Consent + Client ID 발급).

Google Calendar MCP Server URL

현재 Google Calendar 공식 MCP 서버:

https://mcp.googleapis.com/calendar  (또는 Google 공식 발표 URL)

Foundry 환경변수 입력

포비한테 직접 입력 (또는 채팅창):

  • GOOGLE_OAUTH_CLIENT_ID = ...apps.googleusercontent.com
  • GOOGLE_OAUTH_CLIENT_SECRET = GOCSPX-...
  • GOOGLE_OAUTH_REDIRECT_URI = https://myapp.com/api/auth/google/callback
  • GOOGLE_CALENDAR_MCP_URL = https://mcp.googleapis.com/calendar

Refresh Token은 사용자별 DB 저장 (환경변수 X) — 코드에서 자동 처리.

저장하면 자동 재배포 → Google Calendar MCP 연결 활성화 ✅

(선택) 다른 외부 도구도 함께

AI 일정 비서 앱이면 통합 추천:

❓ 자주 묻는 질문

기존 Calendar API랑 뭐가 달라요?
OAuth 토큰은 동일! 직접 Google Calendar API 호출 vs MCP 표준 프로토콜 차이. MCP 장점: AI 비서에 자연스럽게 연결 (예: "다음 주 회의" → 자동 조회 + Slack 알림).
MCP 안 쓰고 직접 SDK가 더 단순한가요?
단순 일정 조회 / 생성만이면 직접 SDK (googleapis) 추천. AI 비서 / 여러 도구 통합이면 MCP Client 추천.
여러 사용자 일정 동시 관리?
가능. 사용자별 Refresh Token DB 저장 → 사용자 본인 일정만 접근. 사용자 간 일정 충돌 감지 (예: 미팅 잡기 봇) 가능.
개인 vs 회사 (Workspace) 캘린더?
Calendar API는 둘 다 지원. 단 회사 Workspace는 organization 정책에 따라 Scope 승인 필요할 수 있음.
Refresh Token이 만료되면?
Test mode = 7일 만료. Production mode (Google 검수 통과) = 영구 (사용자가 직접 취소 X 한). 401 응답 시 재로그인 흐름 안내.

🔗 참고 링크