google-calendar-mcp-serviceaccount

하나의 Google Calendar에 대해 AI 에이전트에게 읽기/쓰기 접근 권한을 부여하는 최소한의 MCP 서버입니다. 대화형 OAuth 대신 서비스 계정(service account) 으로 인증합니다.

서비스 계정을 사용하는 이유

대부분의 Google Calendar MCP 서버는 OAuth를 사용합니다. 실제 다중 사용자 제품처럼 앱이 사용자에게 로그인 및 동의를 요청하는 방식입니다. 자신의 캘린더에만 접근하면 되는 개인 비서에게는 이보다 더 많은 절차가 필요합니다 — 프로덕션 배포, 도메인 인증, 주기적인 재동의 등이요.

서비스 계정은 이 모든 것을 건너뜁니다. 다른 사람과 캘린더를 공유하듯이 서비스 계정의 이메일 주소와 캘린더를 공유하면 됩니다. 자격 증명은 직접 취소하기 전까지 만료되지 않습니다.

절충점: 이메일로 명시적으로 공유할 수 있는 캘린더(개인 Google 계정, 대부분의 Workspace 설정)에서만 작동합니다. 전체 OAuth 권한처럼 사용자 계정 전체에 걸쳐 광범위하게 작동할 수는 없습니다.

비용: 이 글을 작성하는 시점 기준으로 아래 설정의 모든 것은 무료입니다. Google Cloud 프로젝트에 결제 계정이나 신용카드를 연결할 필요가 없습니다. Calendar API의 무료 할당량은 개인 비서가 사용할 수 있는 양을 훨씬 초과합니다. 이는 향후 변경될 수 있으므로, 확실하지 않다면 현재 Google Cloud 요금을 확인하세요.

Related MCP server: Google Calendar MCP Server

도구

delete_event는 의도적으로 포함하지 않았습니다. 에이전트가 캘린더 항목을 삭제할 수 있게 하려면 직접 추가하세요.

설정

AI 코딩 어시스턴트의 도움을 받아 설정하고 있나요? AGENTS.md를 참조하세요. 인간과 에이전트 양쪽 모두를 위한 전체 단계별 지침이 있습니다.

수동으로 진행하는 경우:

1. Google Cloud Console에서: 프로젝트를 만들고, Calendar API를 활성화하고, 서비스 계정(OAuth 클라이언트가 아님)을 만들고, 해당 JSON 키를 다운로드합니다

2. 서비스 계정의 이메일 주소와 Google Calendar를 "이벤트 변경" 권한으로 공유합니다. 캘린더 ID를 기록해 두세요. 자신의 기본 캘린더의 경우 이메일 주소가 곧 ID입니다. 다른 캘린더의 경우 해당 캘린더의 설정 → "캘린더 통합" → "캘린더 ID"에서 찾을 수 있습니다

3. python3 -m venv venv && ./venv/bin/pip install -r requirements.txt

4. .env.example을 .env로 복사하고 키 경로와 캘린더 ID를 입력합니다

5. calendar_server.py를 MCP 클라이언트에 stdio 서버로 등록하고, 해당 두 변수를 환경 변수로 전달합니다

라이선스

MIT — LICENSE 참조.