-
security-
license-
qualityLets LLMs read and manage Google Calendar events.
Last updated -
582
742
MIT License
This server provides Google Calendar integration through MCP protocol with OAuth2 authentication, enabling comprehensive calendar management via Cursor and other MCP clients.
Core Capabilities:
List monthly events - Retrieve all events for a specified year and month
List daily events - Get all events for a specific date (YYYY-MM-DD format)
View event details - Fetch detailed information for a specific event using its ID
Create events - Add new events with title, start/end times, and optional location, description, and attendee emails
Update events - Modify existing events by ID (only provided fields are updated)
Delete events - Remove events using their event ID
Find free time slots - Locate available time blocks of specified duration on a given date for meeting scheduling
Use Cases: Schedule management through AI assistants, meeting coordination, and automated calendar operations via MCP protocol.
Handles OAuth2 authentication flow for secure access to Google services and APIs.
Allows viewing, creating, and managing calendar events through Google Calendar API, including listing monthly events, viewing daily events, retrieving event details, and creating new events.
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"]
}
}
}
참고 및 문의
Google Calendar API 공식 문서: https://developers.google.com/calendar/api
MCP/fastmcp 문서: https://github.com/anysphere/fastmcp
별도의 가상환경/venv 명령은 필요 없습니다. uv가 자동으로 안전한 환경을 만들어줍니다. 설치/실행 중 궁금한 점이 있으면 언제든 문의해 주세요!
Related MCP Servers
- Asecurity-licenseAqualityProvides tools for interacting with Gmail and Calendar APIs. This server enables you to manage your emails and calendar events programmatically through the MCP interface.Last updated -26MIT License
- -security-license-qualityEnables interaction with Gmail and Google Calendar using the MCP protocol, supporting multiple Google accounts, email management, and calendar operations through natural language.Last updated -13MIT License
- -security-license-qualityA Model Context Protocol server that enables natural language interaction with Google Calendar, allowing users to view, create, update, and delete calendar events through context-aware operations.Last updated -141