Google 캘린더 통합 프로젝트
이 프로젝트는 Google 캘린더 API와의 통합을 제공하여 캘린더 이벤트를 프로그래밍 방식으로 관리하고 상호 작용할 수 있도록 합니다.
필수 조건
- Python 3.8 이상
- Google Cloud Platform 계정
- Google 캘린더 API 활성화됨
- OAuth 2.0 자격 증명이 구성되었습니다.
설치 지침
- 저장소 복제지엑스피1
- 가상 환경 설정
python -m venv venv
source venv/bin/activate # On Windows, use `venv\Scripts\activate`
- 종속성 설치
pip install -r requirements.txt
- Google Cloud Platform 설정a. Google Cloud Console 로 이동합니다. b. 새 프로젝트를 만들거나 기존 프로젝트를 선택합니다. c. Google 캘린더 API를 활성화합니다. d. OAuth 2.0 사용자 인증 정보를 만듭니다.
- API 및 서비스 > 자격 증명으로 이동하세요.
- "자격 증명 만들기" > "OAuth 클라이언트 ID"를 클릭하세요.
- "데스크톱 응용 프로그램"을 선택하세요
- 자격 증명 JSON 파일을 다운로드하세요
credentials.json
으로 이름을 바꾸고 프로젝트 루트에 넣으세요.
- 환경 변수프로젝트 루트에 다음 변수를 사용하여
.env
파일을 만듭니다.GOOGLE_APPLICATION_CREDENTIALS=path/to/credentials.json
CALENDAR_ID=your_calendar_id@group.calendar.google.com
용법
- 최초 인증OAuth 인증을 위한 브라우저 창이 열립니다. 안내에 따라 애플리케이션을 승인하세요.
- 애플리케이션 실행
특징
- 캘린더 이벤트를 만들고, 읽고, 업데이트하고, 삭제합니다.
- 반복되는 이벤트 설정
- 이벤트 참석자 관리
- 이벤트 알림 및 미리 알림 처리
프로젝트 구조
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 자격 증명을 안전하게 유지하세요
- 자격 증명과 토큰을 정기적으로 교체하세요
기여하다
- 저장소를 포크하세요
- 기능 브랜치 생성
- 변경 사항을 커밋하세요
- 지점으로 밀어 넣기
- 풀 리퀘스트 만들기
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다. 자세한 내용은 라이선스 파일을 참조하세요.