Google 캘린더 MCP 서버

TypeScript로 구축된 Google 캘린더와 통합된 MCP(Model Context Protocol) 서버입니다.

특징

• OAuth 2.0 인증을 통한 원활한 Google 캘린더 통합

• 자동 인증을 위한 영구 토큰 저장소

• 포괄적인 이벤트 운영으로 일정을 나열하고 관리하세요

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

• 지정된 날짜 사이의 캘린더 이벤트 가져오기

• 실시간 업데이트를 위한 SSE(Server-Sent Events) 전송 옵션

• Claude 및 기타 MCP 호환 AI 어시스턴트와의 간단한 통합

설치

지엑스피1

또는 다음을 사용하여 직접 실행하세요.

필수 조건

1. Node.js(v16 이상)

2. Google Cloud Platform 계정

3. Google 캘린더 API 활성화됨

4. OAuth 2.0 자격 증명

설정

1. Google Cloud 구성

1. Google Cloud Console 로 이동

2. 새 프로젝트를 만들거나 기존 프로젝트를 선택하세요

3. Google 캘린더 API 활성화:

   • "API 및 서비스" > "라이브러리"로 이동합니다.

   • "Google 캘린더 API"를 검색하세요

   • "활성화"를 클릭하세요

4. OAuth 동의 화면 구성:

   • "API 및 서비스" > "OAuth 동의 화면"으로 이동하세요.

   • "외부" 사용자 유형(또는 Google Workspace의 경우 "내부")을 선택하세요.

   • 필수 정보를 입력하세요:

     • 앱 이름: mcp-calendar

     • 사용자 지원 이메일: (귀하의 이메일)

     • 개발자 연락처 정보: (귀하의 이메일)

   • 범위 추가:

     • "범위 추가 또는 제거"를 클릭하세요.

     • " https://www.googleapis.com/auth/calendar.events "를 찾아 선택하세요.

     • 테스트 사용자로 이메일을 추가하세요

   • 설정을 완료하세요

5. OAuth 자격 증명을 만듭니다.

   • "자격 증명"으로 이동

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

   • 애플리케이션 유형으로 "데스크톱 앱"을 선택하세요

   • 이름을 지정합니다(예: "MCP 캘린더 데스크톱 클라이언트").

   • JSON 파일을 다운로드하여 프로젝트 디렉토리에 credentials.json 으로 저장합니다.

2. 환경 구성

프로젝트 루트에 .env 파일을 만듭니다.

용법

서버 시작

표준 WebSocket으로 시작하세요:

SSE(Server-Sent Events)로 시작:

클로드 데스크톱과 함께

claude_desktop_config.json 에 다음을 추가하세요:

인증 프로세스

서버를 처음 실행할 때:

1. 브라우저 창이 자동으로 열립니다

2. Google 계정으로 로그인하세요

3. 요청된 캘린더 권한 부여

4. 인증 토큰은 token.json 에 저장됩니다.

이후 출시 시:

• 서버는 저장된 토큰을 자동으로 사용합니다.

• 토큰이 만료되지 않는 한 브라우저 상호 작용이 필요하지 않습니다.

사용 가능한 도구

개발

프로젝트를 복제하고 설정합니다.

프로젝트를 빌드하세요:

개발 모드에서 실행:

보안 고려 사항

⚠️ 중요 보안 경고 ⚠️

• credentials.json 및 token.json 에는 중요한 인증 정보가 포함되어 있습니다.

• 이러한 파일을 버전 제어에 커밋하거나 공개적으로 공유하지 마십시오.

• 각 사용자는 자신의 OAuth 자격 증명을 생성해야 합니다.

• 자격 증명이 손상되었다고 의심되는 경우 Google Cloud Console에서 즉시 해당 자격 증명을 취소하세요.

• 토큰은 Google 캘린더 데이터에 대한 액세스 권한을 부여합니다.

특허

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

기여하다

기여를 환영합니다! 풀 리퀘스트를 제출해 주세요.

1. 저장소를 포크하세요

2. 기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )

3. 변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )

4. 브랜치에 푸시( git push origin feature/amazing-feature )

5. 풀 리퀘스트 열기