Integrating Google Calendar with Claude Desktop: A Complete Hand-off Guide (MCP)

Google Calender Claude Desktop에 연동하기 (MCP)

 

목적: 일반인이 Claude를 통해 Google Calendar 관리
준비사항: Google 계정, Claude Desktop

실습환경: macOS Sequoia

 

 

Google Cloud Console 접속 및 계정 연동

크롬으로 Google Cloud Console 을 검색해주세요.

 

Chrome에서 https://console.cloud.google.com/ 접속

캘린더 연동할 계정으로 로그인해주세요.

연동하는 과정에서 주소, 폰 인증, 결제 카드 등록 (과금 없음, 크레딧 제공) 해주세요.

Google Cloud Console에서 우측 상단에 활성화 버튼을 클릭하지 않으면 과금 안됩니다.

무료로 시작하기 클릭해줍니다.

서비스약관 위 두개 선택후 계속

개인정보 입력해주시고 계속 클릭해주세요.

 

 

폰 인증 해주시고 결제번호 입력해주시고 계속 클릭해주세요.

 

카드 번호 입력해주시고 무료로 시작하기 클릭해주세요.

이제 google cloud platform (이하 GCP로 줄일게요)을 사용할 수 있습니다. 닫기 눌려주세요.

 

Google Calendar API 활성화

검색창에 "google calendar" 입력

Google Calendar API 선택
"관리" 버튼 클릭 (첫 사용시 "사용" 버튼)

 

OAuth 클라이언트 ID 생성

 

프로젝트 생성

GCP 처음 사용하신다면 프로젝트가 없을겁니다. GCP는 프로젝트기반으로 API등을 관리해서 생성해줘야합니다.

동의 화면 구성 클릭해줍니다.

시작하기

 

프로젝트 구성해주세요.

앱 이름은 임의로 입력해주세요.

사용자 지원 이메일은 해당 계정의 gmail을 입력해주세요.

 

 

만들기 클릭해주세요.

프로젝트 생성 완료입니다.

 

다시 검색창에 "google calendar" 입력

왼쪽 메뉴 → 사용자 인증 정보
사용자 인증 정보 만들기 → OAuth 클라이언트 ID

 

애플리케이션 유형: 데스크톱 앱 선택해주세요.

OAuth 클라이언트 ID 만들기

이름: MCP (임의로 입력해주세요.)

만들기 클릭해주세요.

 

 

JSON 다운로드 → gcp-oauth.keys.json으로 문서 디렉토리에 저장

claude desktop에 MCP 설정에 사용할 예정이니 파일명을 똑같이 따라해주세요.

Claude Desktop에 google calendar 연동

터미널을 켜주세요. > cmd + space 입력 > Spotlight 열기 > "터미널" 입력 후 엔터

 

터미널이 실행되면 프롬프트에 다음 명령어 입력해주시고

cd ~/Documents && pwd | pbcopy

 

메모 열어서 cmd + v 로 붙여넣기

claude desktop에 MCP 설정에 사용할 예정입니다.

Claude Desktop 설정

Claude Desktop 실행

 

설정... → 개발자 → 설정 편집 → claude_desktop_config.json 선택

우클릭 → 다음으로 열기 → 텍스트 편집기

다음과 같이 작성해주시되 GOOGLE_OAUTH_CREDENTIALS 에 메모장에 넣은 경로를 복붙해서 붙여주세요.

{
  "mcpServers": {
    "google-calendar": {
      "command": "npx",
      "args": ["@cocal/google-calendar-mcp"],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS": "{{메모장에 붙여넣은 경로 복붙해주세요.}}/gcp-oauth.keys.json"
      }
    }
  }
}

다음과 같이 작성해주시고 저장해주세요.

 

 

Claude Desktop을 종료하고 다시 실행해줍니다.

google-calendar 연동이 잘 되었다면 소셜로그인이 뜰겁니다. 그때 해당 구글 계정으로 로그인해주신 후

claude에서 google calendar를 사용하시면 됩니다.

레퍼런스:

https://www.gpters.org/nocode/post/mcp-google-calendar-constant-169osXXFLlAEesR

https://github.com/nspady/google-calendar-mcp#