Google Calendar MCP

Integrates with the Google Calendar API to manage events and schedules using OAuth2 authentication.

GitHub

Google Calendar MCP

개요

Google Calendar와 연동되는 MCP stdio 서버입니다. Cursor 등에서 MCP 프로토콜로 일정을 조회, 생성, 상세 조회할 수 있습니다. 인증은 Google OAuth2를 사용합니다.

주요 기능

  • Google Calendar API 연동
  • MCP stdio 서버로 일정 조회, 생성, 상세 조회 기능 제공
  • Google OAuth2 인증 처리

기술 스택

  • Python 3.13 이상 (권장: 3.13.3)
  • 패키지 매니저: uv
  • MCP 서버: fastmcp
  • Google API 연동: google-api-python-client, google-auth, google-auth-oauthlib
  • 인증: OAuth2 (Google)

구현 기능 및 MCP 메서드

기능MCP 메서드설명
1달 치 일정 보기list_month_events지정한 연/월의 모든 일정 목록 조회
특정 일자 일정 보기list_day_events지정한 날짜의 모든 일정 목록 조회
일정 상세 보기get_event_detail일정 ID로 상세 정보 조회
일정 등록create_event새로운 일정 생성 (참여자(이메일) 추가 가능)
일정 수정update_event일정 ID로 일정 정보 수정 (제목, 시간 등)
일정 삭제delete_event일정 ID로 일정 삭제
빈 시간 찾기find_free_slots특정 날짜의 N분 이상 빈 시간대 찾기 (회의 시간 조율에 유용)

1. uv 설치 (최초 1회만)

macOS/Homebrew

brew install uv

또는 공식 설치 스크립트

curl -Ls https://astral.sh/uv/install.sh | sh

Windows (PowerShell)

iwr -useb https://astral.sh/uv/install.ps1 | iex

2. MCP 패키지 다운로드

git clone https://github.com/AnByoungHyun/google_calendar_mcp.git
cd google_calendar_mcp

3. 패키지 설치

uv sync
  • 위 명령어 한 줄로 모든 패키지가 자동 설치됩니다.

4. Cursor MCP 등록 예시

.cursor/mcp.json 예시:

{
  "mcpServers": {
    ...
    "google-calendar": {
      "command": "uv",
      "args": ["--directory", "<google_calendar_mcp_path>", "run", "google_calendar_mcp"]
    }
  }
}

참고 및 문의

별도의 가상환경/venv 명령은 필요 없습니다. uv가 자동으로 안전한 환경을 만들어줍니다. 설치/실행 중 궁금한 점이 있으면 언제든 문의해 주세요!

관련 서버