Google 캘린더 통합 프로젝트

이 프로젝트는 Google 캘린더 API와의 통합을 제공하여 캘린더 이벤트를 프로그래밍 방식으로 관리하고 상호 작용할 수 있도록 합니다.

필수 조건

• Python 3.8 이상

• Google Cloud Platform 계정

• Google 캘린더 API 활성화됨

• OAuth 2.0 자격 증명이 구성되었습니다.

Related MCP server: Google Calendar MCP Server

설치 지침

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 Google 캘린더 통합 프로젝트를 자동으로 설치하려면:

지엑스피1

수동 설치

1. 저장소 복제

   git clone https://github.com/Avik-creator/googlecalendarMCP
   cd googlecalendarMCP

2. 가상 환경 설정

   python -m venv venv
   source venv/bin/activate  # On Windows, use `venv\Scripts\activate`

3. 종속성 설치

   pip install -r requirements.txt

4. Google Cloud Platform 설정

   a. Google Cloud Console 로 이동합니다. b. 새 프로젝트를 만들거나 기존 프로젝트를 선택합니다. c. Google 캘린더 API를 활성화합니다. d. OAuth 2.0 사용자 인증 정보를 만듭니다.

   • API 및 서비스 > 자격 증명으로 이동하세요.

   • "자격 증명 만들기" > "OAuth 클라이언트 ID"를 클릭하세요.

   • "데스크톱 응용 프로그램"을 선택하세요

   • 자격 증명 JSON 파일을 다운로드하세요

   • credentials.json 으로 이름을 바꾸고 프로젝트 루트에 넣으세요.

5. 환경 변수

   프로젝트 루트에 다음 변수를 사용하여 .env 파일을 만듭니다.

   GOOGLE_APPLICATION_CREDENTIALS=path/to/credentials.json
   CALENDAR_ID=your_calendar_id@group.calendar.google.com

용법

1. 최초 인증

   python auth.py

   OAuth 인증을 위한 브라우저 창이 열립니다. 안내에 따라 애플리케이션을 승인하세요.

2. 애플리케이션 실행

   python main.py

특징

• 캘린더 이벤트를 만들고, 읽고, 업데이트하고, 삭제합니다.

• 반복되는 이벤트 설정

• 이벤트 참석자 관리

• 이벤트 알림 및 미리 알림 처리

프로젝트 구조

googlecalendarMCP/
├── auth.py              # Authentication handling
├── main.py             # Main application entry point
├── requirements.txt    # Project dependencies
├── .env               # Environment variables
├── credentials.json   # Google OAuth credentials
└── token.json        # Generated OAuth token

종속성

이 프로젝트는 다음과 같은 주요 종속성을 사용합니다.

• google-auth-oauthlib

• 구글 인증 httplib2

• 구글 API 파이썬 클라이언트

• 파이썬-dotenv

배포된 구성:

{
  "mcpServers": {
    "google_calendar_mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp-google-calendar.avikm744.workers.dev/sse"
      ]
    }
  }
}

보안 참고 사항

• credentials.json , token.json 또는 .env 파일을 버전 제어에 커밋하지 마십시오.

• OAuth 자격 증명을 안전하게 유지하세요

• 자격 증명과 토큰을 정기적으로 교체하세요

기여하다

1. 저장소를 포크하세요

2. 기능 브랜치 생성

3. 변경 사항을 커밋하세요

4. 지점으로 밀어 넣기

5. 풀 리퀘스트 만들기

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.