Google Calendar MCP Server

Integrations

  • Provides tools for managing Google Calendar, including listing calendars, creating/reading/updating/deleting events, and fetching events between specified dates with OAuth 2.0 authentication.

Google 캘린더 MCP 서버

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

특징

  • OAuth 2.0 인증을 통한 원활한 Google 캘린더 통합
  • 자동 인증을 위한 영구 토큰 저장소
  • 포괄적인 이벤트 운영으로 일정을 나열하고 관리하세요
  • 캘린더 이벤트를 만들고, 읽고, 업데이트하고, 삭제합니다.
  • 지정된 날짜 사이의 캘린더 이벤트 가져오기
  • 실시간 업데이트를 위한 SSE(Server-Sent Events) 전송 옵션
  • Claude 및 기타 MCP 호환 AI 어시스턴트와의 간단한 통합

설치

지엑스피1

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

npx -y mcp-google-calendar

필수 조건

  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
      • 사용자 지원 이메일: (귀하의 이메일)
      • 개발자 연락처 정보: (귀하의 이메일)
    • 범위 추가:
    • 설정을 완료하세요
  5. OAuth 자격 증명을 만듭니다.
    • "자격 증명"으로 이동
    • "자격 증명 만들기" > "OAuth 클라이언트 ID"를 클릭하세요.
    • 애플리케이션 유형으로 "데스크톱 앱"을 선택하세요
    • 이름을 지정합니다(예: "MCP 캘린더 데스크톱 클라이언트").
    • JSON 파일을 다운로드하여 프로젝트 디렉토리에 credentials.json 으로 저장합니다.

2. 환경 구성

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

# Server configuration PORT=3420 # Google Calendar API configuration CREDENTIALS_PATH=./credentials.json

용법

서버 시작

표준 WebSocket으로 시작하세요:

npx -y mcp-google-calendar

SSE(Server-Sent Events)로 시작:

npx -y mcp-google-calendar --sse

클로드 데스크톱과 함께

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

{ "mcpServers": { "mcp-google-calendar": { "command": "npx", "args": ["-y", "mcp-google-calendar"], "env": { "CREDENTIALS_PATH": "/path/to/your/credentials.json" } } } }

인증 프로세스

서버를 처음 실행할 때:

  1. 브라우저 창이 자동으로 열립니다
  2. Google 계정으로 로그인하세요
  3. 요청된 캘린더 권한 부여
  4. 인증 토큰은 token.json 에 저장됩니다.

이후 출시 시:

  • 서버는 저장된 토큰을 자동으로 사용합니다.
  • 토큰이 만료되지 않는 한 브라우저 상호 작용이 필요하지 않습니다.

사용 가능한 도구

도구설명
list_calendars사용 가능한 모든 캘린더 가져오기
list_calendar_events지정된 날짜 사이의 이벤트 검색
create_calendar_event캘린더에 새 이벤트를 추가하세요
get_calendar_event특정 이벤트에 대한 세부 정보 가져오기
edit_calendar_event기존 캘린더 이벤트 수정
delete_calendar_event캘린더에서 이벤트 제거

개발

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

git clone https://github.com/am2rican5/mcp-google-calendar.git cd mcp-google-calendar npm install

프로젝트를 빌드하세요:

npm run build

개발 모드에서 실행:

npm start

보안 고려 사항

⚠️ 중요 보안 경고 ⚠️

  • credentials.jsontoken.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. 풀 리퀘스트 열기
-
security - not tested
A
license - permissive license
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

모델 컨텍스트 프로토콜을 통해 Google 캘린더와 AI 어시스턴트를 통합하여 사용자가 자연어 상호 작용을 통해 캘린더 이벤트를 보고 관리할 수 있도록 합니다.

  1. 특징
    1. 설치
      1. 필수 조건
        1. 설정
          1. 1. Google Cloud 구성
          2. 2. 환경 구성
        2. 용법
          1. 서버 시작
          2. 클로드 데스크톱과 함께
          3. 인증 프로세스
        3. 사용 가능한 도구
          1. 개발
            1. 보안 고려 사항
              1. 특허
                1. 기여하다

                  Related MCP Servers

                  • -
                    security
                    F
                    license
                    -
                    quality
                    Google Calendar integration in Cursor IDE. This server enables AI assistants to manage Google Calendar events through natural language interactions.
                    Last updated -
                    5
                    0
                    5
                    JavaScript
                  • -
                    security
                    A
                    license
                    -
                    quality
                    Server for Google Calendar integration in Cluade Desktop with auto authentication support. This server enables AI assistants to manage Google Calendar events through natural language interactions.
                    Last updated -
                    22
                    6
                    JavaScript
                    MIT License
                  • -
                    security
                    F
                    license
                    -
                    quality
                    Allows interaction with Google Calendar through Claude Desktop using the Model Context Protocol, enabling calendar event management and schedule analysis.
                    Last updated -
                    2
                    JavaScript
                    • Apple
                  • -
                    security
                    A
                    license
                    -
                    quality
                    A Model Context Protocol server that integrates Google Calendar with Claude Desktop, enabling users to manage calendar events (view, create, update, delete) through natural language.
                    Last updated -
                    133
                    21
                    TypeScript
                    MIT License

                  View all related MCP servers

                  ID: 0j32839h00