local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables AI assistants to manage Google Calendar events, including creating, retrieving, updating, and deleting events, as well as listing events within a specified time range.
Used for authentication via Google Cloud Project and OAuth 2.0 credentials to access the Google Calendar API.

캘린더 자동 인증 MCP 서버

Cluade Desktop에 Google 캘린더를 통합하고 자동 인증을 지원하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 AI 비서가 자연어 상호작용을 통해 Google 캘린더 일정을 관리할 수 있습니다.

특징

제목, 시간, 설명 및 위치를 사용하여 캘린더 이벤트를 만듭니다.
이벤트 ID로 이벤트 세부 정보 검색
기존 이벤트 업데이트(제목, 시간, 설명, 위치)
이벤트 삭제
지정된 시간 범위 내의 이벤트 나열
Google 캘린더 API와의 완벽한 통합
자동 브라우저 실행을 통한 간단한 OAuth2 인증 흐름
데스크톱 및 웹 애플리케이션 자격 증명 모두 지원
편의성을 위한 글로벌 자격 증명 저장

설치 및 인증

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 Calendar AutoAuth Server를 자동으로 설치하려면:

지엑스피1

Google Cloud 프로젝트를 만들고 자격 증명을 얻으세요.a. Google Cloud 프로젝트 만들기:
- Google Cloud Console 로 이동
- 새 프로젝트를 만들거나 기존 프로젝트를 선택하세요
- 프로젝트에 Google 캘린더 API를 활성화하세요
b. OAuth 2.0 자격 증명을 생성합니다.
- "API 및 서비스" > "자격 증명"으로 이동하세요.
- "자격 증명 만들기" > "OAuth 클라이언트 ID"를 클릭하세요.
- 애플리케이션 유형으로 "데스크톱 앱" 또는 "웹 애플리케이션"을 선택하세요.
- 이름을 지정하고 "만들기"를 클릭하세요.
- 웹 애플리케이션의 경우 권한이 부여된 리디렉션 URI에 http://localhost:3000/oauth2callback 추가합니다.
- 클라이언트의 OAuth 키 JSON 파일을 다운로드하세요.
- 키 파일의 이름을 gcp-oauth.keys.json 으로 바꾸세요.
인증 실행:두 가지 방법으로 인증할 수 있습니다.a. 글로벌 인증(권장):
# First time: Place gcp-oauth.keys.json in your home directory's .calendar-mcp folder mkdir -p ~/.calendar-mcp mv gcp-oauth.keys.json ~/.calendar-mcp/ # Run authentication from anywhere npx @gongrzhe/server-calendar-autoauth-mcp auth
b. 로컬 인증:
# Place gcp-oauth.keys.json in your current directory # The file will be automatically copied to global config npx @gongrzhe/server-calendar-autoauth-mcp auth
인증 과정은 다음과 같습니다.
- 현재 디렉토리 또는 ~/.calendar-mcp/ 에서 gcp-oauth.keys.json 찾으세요.
- 현재 디렉토리에서 발견되면 ~/.calendar-mcp/ 로 복사하세요.
- Google 인증을 위해 기본 브라우저를 엽니다.
- 자격 증명을 ~/.calendar-mcp/credentials.json 으로 저장합니다.
메모 :
- 인증이 성공하면 자격 증명은 ~/.calendar-mcp/ 에 전역적으로 저장되며 모든 디렉토리에서 사용할 수 있습니다.
- 데스크톱 앱과 웹 애플리케이션 자격 증명이 모두 지원됩니다.
- 웹 애플리케이션 자격 증명의 경우 권한이 있는 리디렉션 URI에 http://localhost:3000/oauth2callback 추가해야 합니다.
Claude Desktop에서 구성:

{
  "mcpServers": {
    "calendar": {
      "command": "npx",
      "args": [
        "@gongrzhe/server-calendar-autoauth-mcp"
      ]
    }
  }
}

도커 지원

Docker를 사용하는 것을 선호하는 경우:

입증:

docker run -i --rm \
  --mount type=bind,source=/path/to/gcp-oauth.keys.json,target=/gcp-oauth.keys.json \
  -v mcp-calendar:/calendar-server \
  -e CALENDAR_OAUTH_PATH=/gcp-oauth.keys.json \
  -e "CALENDAR_CREDENTIALS_PATH=/calendar-server/credentials.json" \
  -p 3000:3000 \
  mcp/calendar auth

용법:

{
  "mcpServers": {
    "calendar": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "mcp-calendar:/calendar-server",
        "-e",
        "CALENDAR_CREDENTIALS_PATH=/calendar-server/credentials.json",
        "mcp/calendar"
      ]
    }
  }
}

사용 예

이 서버는 Claude Desktop을 통해 사용할 수 있는 여러 도구를 제공합니다.

이벤트 만들기

{
  "summary": "Team Meeting",
  "start": {
    "dateTime": "2024-01-20T10:00:00Z"
  },
  "end": {
    "dateTime": "2024-01-20T11:00:00Z"
  },
  "description": "Weekly team sync",
  "location": "Conference Room A"
}

이벤트 목록

{
  "timeMin": "2024-01-01T00:00:00Z",
  "timeMax": "2024-12-31T23:59:59Z",
  "maxResults": 10,
  "orderBy": "startTime"
}

이벤트 업데이트

{
  "eventId": "event123",
  "summary": "Updated Meeting Title",
  "start": {
    "dateTime": "2024-01-20T11:00:00Z"
  },
  "end": {
    "dateTime": "2024-01-20T12:00:00Z"
  }
}

이벤트 삭제

{
  "eventId": "event123"
}

보안 참고 사항

OAuth 자격 증명은 로컬 환경( ~/.calendar-mcp/ )에 안전하게 저장됩니다.
서버는 오프라인 액세스를 사용하여 지속적인 인증을 유지합니다.
버전 제어에 자격 증명을 공유하거나 커밋하지 마십시오.
Google 계정 설정에서 사용하지 않는 액세스 권한을 정기적으로 검토하고 취소하세요.
자격 증명은 전역적으로 저장되지만 현재 사용자만 액세스할 수 있습니다.

문제 해결

OAuth 키를 찾을 수 없습니다
- gcp-oauth.keys.json 이 현재 디렉토리 또는 ~/.calendar-mcp/ 에 있는지 확인하세요.
- 파일 권한 확인
잘못된 자격 증명 형식
- OAuth 키 파일에 web 또는 installed 자격 증명이 포함되어 있는지 확인하세요.
- 웹 애플리케이션의 경우 리디렉션 URI가 올바르게 구성되었는지 확인하세요.
포트가 이미 사용 중입니다
- 포트 3000이 이미 사용 중이면 인증을 실행하기 전에 포트를 비워주세요.
- 해당 포트를 사용하여 프로세스를 찾아 중지할 수 있습니다.

기여하다

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

특허

이 프로젝트는 ISC 라이선스에 따라 라이선스가 부여되었습니다.

작가

공그르제

지원하다

문제가 발생하거나 질문이 있는 경우 GitHub 저장소에 문제를 제출하세요.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

자동 인증 기능을 갖춘 Cluade Desktop의 Google 캘린더 통합 서버입니다. 이 서버를 통해 AI 비서가 자연어 상호작용을 통해 Google 캘린더 일정을 관리할 수 있습니다.

Calendar AutoAuth MCP Server