Claude와 Google Calendar의 실전 연동기: MCP + Cursor로 빠르게 구축하기
소개
MCP(Model Context Protocol) 관련 자료는 다양한데, 정작 Claude와 Google Calendar를 연동하는 실전 사례는 찾기 어려웠습니다. 그래서 직접 실습하며 Claude가 내 구글 캘린더 일정을 조회하거나 새 일정을 만들 수 있도록 연동해보았습니다. 이 글에서는 그 과정을 기술적으로 정리하고자 합니다.
진행 방법
🧰 사용 도구
Claude (Anthropic)
MCP 서버 (nspady/google-calendar-mcp)
Google Cloud Console (OAuth 설정)
Node.js, npm
Cursor (개발 생산성 툴)
Vitest (테스트 프레임워크)
🔐 인증(OAuth) 설정
Google Cloud Console에서 프로젝트 생성 후 Calendar API 활성화
API 및 서비스 선택
Google Calendar API 선택
'사용' 선택 (아래 화면에 선 '관리', 전 이미 '사용'을 클릭했기 때문에 '관리'로 표현)
사용자 인증 정보 만들기 > OAuth 클라이언트 ID
데스크탑 앱 선택. (꼭. 필수!!!)
'이름' 대충 넣고, '만들기' 선택하면, 아래처럼 생성 팝업 나타남.
(참고로 아래 OAuth는 이미 삭제된 거임. 보안 걱정 마셈)"OAuth 클라이언트 다운로드" 선택해서 json 다운로드
위 json 파일을 "
gcp-oauth.keys.json" 이름으로 저장
🔐 Cursor로 인증(OAuth) 실행
Cursor > Chat 창(ctrl/cmd + i)을 열고
https://github.com/nspady/google-calendar-mcp 넣고 enter!
(clone repo : github 저장된 파일들을 가져오는 것을 자동 진행하는 셈 )GitHub는 개발자들이 코드를 저장하고 공유하는 플랫폼.
코딩 경험이 없어도 GitHub에서 유용한 라이브러리를 찾아 활용 가능.
Cursor가 알아서 진행. 계속 "ctrl + enter"를 눌러서 run / accept 반복
다만, 중간에 프로젝트 폴더 생성되면, 아까 구글에서 다운받아 둔
gcp-oauth.keys.json인증 파일을 폴더 루트에 저장하라고 할 때, 잘 저장해 줌.Cursor에게 아래 명령어로 인증 시킴. 그냥 니가 알아서 하라고 한 상황
npm install
npm run auth
인증 성공 시
.gcp-saved-tokens.json파일이 생성됨
⚙️ Claude에 MCP 연동
claude_desktop_config.json파일에 MCP 서버 등록:이것도 Cursor에게 해달라고 시킴
{
"mcpServers": {
"google-calendar": {
"command": "node",
"args": ["<절대경로>/build/index.js"]
}
}
}
Claude를 재시작하면 Google Calendar를 활용한 자연어 인터페이스 사용 가능 💡
🧪 문제 해결 팁
실행 오류: Cursor가 명령어를 실행하지 못하는 권한 오류 발생
"win + r" > "cmd" 프롬프트 창을 열고, cursor가 하라는 대로 명령어 실행
🖥️ 개발 환경 개선 팁
Cursor 사용: OAuth 키 설정, 코드 탐색, 디버깅 등에서 속도가 훨씬 빨랐음
결과와 배운 점
Claude와 Google Calendar 연동 시, OAuth 설정과 MCP 서버 연결이 핵심이다.
Cursor를 활용하면 MCP 프로젝트 탐색 및 설정이 훨씬 빨라지는 듯.
Google Calendar 사용자라면 Claude와의 연동은 업무 일정 확인 및 자동화에 실질적으로 유용하다!