Google Calendar MCP
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.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Google Calendar MCP show my schedule for next Tuesday"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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_mcp3. 패키지 설치
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가 자동으로 안전한 환경을 만들어줍니다. 설치/실행 중 궁금한 점이 있으면 언제든 문의해 주세요!
Available Tools
5 toolscreate_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
Scored across 5 tools
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.
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.
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.
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
Related MCP Connectors
A MCP server that works with Google Calendar to manage event listing, reading, and updates.
Hosted Google Calendar MCP server for AI agents. No self-hosting or Google Cloud setup.
MCP server for Cronofy — read calendars, events and free/busy, and create, update or delete events.
Streamable HTTP MCP server for Google Calendar and Sheets with OAuth login.
Related MCP Servers
- -licenseNot gradedqualityNot gradedmaintenanceGoogle Calendar integration in Cursor IDE. This server enables AI assistants to manage Google Calendar events through natural language interactions.13 npm5ISC
- AlicenseAqualityCmaintenanceA Model Context Protocol server that integrates Google Calendar with Claude Desktop, enabling users to manage calendar events (view, create, update, delete) through natural language.5167 npm59MIT
- AlicenseNot gradedqualityDmaintenanceA 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.79 npm1MIT
- AlicenseDqualityDmaintenanceMCP server for interacting with Google Calendar, enabling reading events from public calendars and, with OAuth, creating, updating, and deleting events.1ISC