takumi0706/google-calendar-mcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

59 stars 11 forks 품질 80 트렌드 21MIT

Repository Install

Google 캘린더 MCP 서버 Claude 데스크톱 통합

개요

버전 2.0.0는 MCP 프로토콜 개정 2026-07-28로 이동하고 OAuth 교류에 PKCE를 실행합니다. 그것은 요구합니다. 변경의 전체 목록에서 아래 버전의 역사를 참조하십시오. Google 캘린더 MCP 서버는 Google 캘린더와 Claude 데스크톱 간의 통합을 가능하게하는 MCP (모델 Context Protocol) 서버 구현입니다. 이 프로젝트는 Claude가 사용자의 Google 캘린더와 상호 작용하여 자연 언어 상호 작용을 통해 표시, 생성, 업데이트 및 삭제 캘린더 이벤트를 제공합니다.

개요(AI 번역)

** 엑세스 업데이 트 라운지 ** 버전 2.0.0는 MCP 프로토콜 개정 2026-07-28로 이동하고 OAuth 흐름에 PKCE를 구현합니다. **Node.js 20 이상이 필요합니다 **. 변경의 전체 목록에서 아래 버전의 역사를 참조하십시오.

프로젝트 개요

Google 캘린더 MCP 서버는 Google 캘린더와 Claude 데스크톱 간의 통합을 가능하게하는 MCP (모델 Context Protocol) 서버 구현입니다. 이 프로젝트는 Claude가 사용자의 Google 캘린더와 상호 작용하여 자연 언어 상호 작용을 통해 표시, 생성, 업데이트 및 삭제 캘린더 이벤트를 제공합니다.

핵심 특징

Google 캘린더 통합: Claude Desktop과 Google Calendar API 사이의 브리지를 제공합니다.
MCP 구현: AI Assistant Tool 통합에 대한 Model Context Protocol 사양을 따르십시오.
OAuth2 인증: Google API 인증 흐름을 안전하게 처리
** 이벤트 관리**: 포괄적인 캘린더 이벤트 운영 지원 (get, create, update, delete)
** 색상 지원**: ColorId 매개 변수를 사용하여 이벤트 색상 설정 및 업데이트 할 수있는 능력
** STDIO 수송 **: Claude Desktop과 통신용 표준 입력/출력

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

Google Calendar MCP Server

🔔 VERSION UPDATE NOTICE 🔔
Version 2.0.0 moves to MCP protocol revision 2026-07-28 and implements PKCE on the OAuth flow. It requires Node.js 20 or newer. See the version history below for the full list of changes.

Project Overview

Google Calendar MCP Server is an MCP (Model Context Protocol) server implementation that enables integration between Google Calendar and Claude Desktop. This project enables Claude to interact with the user’s Google Calendar, providing the ability to display, create, update, and delete calendar events through natural language interaction.

Core Features

Google Calendar integration: Provides a bridge between Claude Desktop and the Google Calendar API
MCP implementation: Follows the Model Context Protocol specification for AI assistant tool integration
OAuth2 authentication: Handles the Google API authentication flow securely
Event management: Supports comprehensive calendar event operations (get, create, update, delete)
Color support: Ability to set and update event colors using colorId parameter
STDIO transport: Uses standard input/output for communication with Claude Desktop

Technical Architecture

This project uses:

TypeScript: For type-safe code development
MCP SDK: Uses @modelcontextprotocol/server v2 (protocol revision 2026-07-28, with the 2025 revisions still served for older clients)
Google API: Uses googleapis for Google Calendar API access
Hono: Lightweight and fast web framework for the authentication server
google-auth-library: Drives the OAuth2 authorization code flow with PKCE (S256)
Zod: Implements schema validation for request/response data
Environment-based configuration: Uses dotenv for configuration management
AES-256-GCM: For token encryption using Node.js crypto module
Open: For automatic browser launching during authentication
Readline: For manual authentication input in server environments
Jest: For unit testing and coverage
GitHub Actions: For CI/CD

Main Components

MCP Server: Core server implementation that handles communication with Claude Desktop
Google Calendar Tools: Calendar operations (retrieval, creation, update, deletion)
Authentication Handler: Management of OAuth2 flow with Google API
Schema Validation: Ensuring data integrity in all operations
Token Manager: Secure handling of authentication tokens

Available Tools

GitHub에서 전체 README 보기

설치

npx -y @takumi0706/google-calendar-mcp

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "google-calendar": {
      "command": "npx",
      "args": [
        "-y",
        "@takumi0706/google-calendar-mcp"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "your_client_id",
        "GOOGLE_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_REDIRECT_URI": "http://localhost:4153/oauth2callback"
      }
    }
  }
}