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 메서드

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"]
    }
  }
}

참고 및 문의

• Google Calendar API 공식 문서: https://developers.google.com/calendar/api

• MCP/fastmcp 문서: https://github.com/anysphere/fastmcp

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