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 "Install 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 MCPshow 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 Workspace 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가 자동으로 안전한 환경을 만들어줍니다. 설치/실행 중 궁금한 점이 있으면 언제든 문의해 주세요!
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.