Skip to main content
Glama
Google Calendar MCP

Google Calendar MCP

by AnByoungHyun

Google Calendar MCP

개요

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

Related MCP server: Google Calendar MCP Server

주요 기능

  • 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가 자동으로 안전한 환경을 만들어줍니다. 설치/실행 중 궁금한 점이 있으면 언제든 문의해 주세요!

Available Tools

5 tools
create_eventC

새로운 일정 생성 (attendees: 이메일 리스트)

Inputs: end (required), start (required), summary (required), attendees, +2 more.

get_event_detailC

일정 ID로 상세 정보 조회

Inputs: event_id (required).

list_day_eventsC

지정한 날짜(YYYY-MM-DD)의 모든 일정 목록 조회

Inputs: date (required).

list_month_eventsC

지정한 연/월의 모든 일정 목록 조회

Inputs: month (required), year (required).

update_eventB

일정 ID로 일정 정보 수정 (전달된 값만 반영)

Inputs: event_id (required), attendees, description, end, +3 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose with no ambiguity: create_event, get_event_detail, list_day_events, list_month_events, and update_event target specific actions on calendar events. The descriptions clarify their unique scopes, such as day vs. month listing, preventing misselection.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (e.g., create_event, get_event_detail, list_day_events). There are no deviations in style or convention, making the set predictable and readable for agents.

    Tool Count4/5

    With 5 tools, the count is well-scoped for a Google Calendar server, covering core operations like CRUD and listing. It's slightly lean but reasonable, as each tool earns its place without feeling thin or excessive for the domain.

    Completeness4/5

    The tool surface provides strong coverage for event management, including create, read (get and list), and update operations. A minor gap is the lack of a delete_event tool, which agents might need to work around, but core workflows are well-supported.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers