Google 캘린더 MCP 서버

“Google 캘린더” MCP 서버란 무엇을 하나요?

Google 캘린더 MCP 서버는 AI 어시스턴트가 Google 캘린더와 매끄럽게 상호작용할 수 있도록 해주는 Model Context Protocol(MCP) 서버입니다. 이 서버를 통해 AI 에이전트는 여러 캘린더의 이벤트 목록 열람, 이벤트 생성 또는 수정, 반복 이벤트 처리, 사용자 가용성 확인, 이미지나 웹 링크 같은 비표준 소스에서 이벤트 추가까지 다양한 캘린더 데이터를 접근·관리·조작할 수 있습니다. AI 시스템과 Google 캘린더 간의 다리 역할을 하여, 개발자가 일정 관리, 이벤트 자동화, 가용성 질의 등을 쉽게 자동화하고, 팀과 개인 모두의 생산성과 워크플로우를 크게 높일 수 있습니다.

프롬프트 목록

사용 가능한 문서나 저장소 파일에 명시된 프롬프트 템플릿이 없습니다.

리소스 목록

문서나 저장소 파일에 명시적으로 설명된 MCP “리소스"가 없습니다.

도구 목록

• 이벤트 목록화: 여러 Google 캘린더에서 이벤트를 한 번에 조회할 수 있습니다.
• 이벤트 생성: 사용자의 Google 캘린더에 새 이벤트를 생성할 수 있습니다.
• 이벤트 수정: 기존 캘린더 이벤트의 세부 정보를 수정할 수 있습니다.
• 이벤트 삭제: 캘린더에서 이벤트를 삭제할 수 있습니다.
• 이벤트 검색: 특정 캘린더 이벤트를 검색할 수 있습니다.
• Free/Busy 쿼리: 여러 캘린더의 가용 시간 또는 바쁜 시간을 확인할 수 있습니다.
• 스마트 일정 잡기: 자연어 이해로 날짜/시간을 해석해 일정 예약이 가능합니다.
• 지능형 가져오기: 이미지, PDF, 웹 링크로부터 캘린더 이벤트를 추가할 수 있습니다.

MCP 서버 활용 사례

• 개인 및 팀 일정 관리: Google 캘린더의 이벤트 생성/수정/삭제를 자동화해 개인 및 협업 일정 관리를 간소화합니다.
• 회의 일정 조율: 여러 사용자 또는 캘린더의 free/busy 상태를 질의해 모두가 가능한 회의 시간을 쉽게 찾을 수 있습니다.
• 이벤트 관리 자동화: AI 에이전트가 반복 이벤트 관리, 이벤트 세부 정보 수정, 복잡한 일정 시나리오 처리 등을 할 수 있습니다.
• 스마트 이벤트 가져오기: 이메일, 이미지, PDF, 웹 링크에서 이벤트 세부 정보를 파싱해 자동으로 캘린더에 추가합니다.
• AI 기반 리마인더 및 일정 계획: 자연어 처리로 AI 챗에서 바로 리마인더 설정, 일정 등록, 하루 계획 등이 가능합니다.

설정 방법

Windsurf

저장소에 Windsurf용 설치 안내는 제공되지 않습니다.

Claude

1. Google Cloud 프로젝트를 생성하고 Calendar API를 활성화한 뒤, OAuth 2.0 자격 증명(Desktop 앱 타입)을 준비하세요.
2. Claude Desktop 설정 파일의 위치를 찾으세요:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
3. mcpServers 섹션에 Google 캘린더 MCP 서버를 다음과 같이 추가하세요:

   {
     "mcpServers": {
       "google-calendar": {
         "command": "npx",
         "args": ["@cocal/google-calendar-mcp"],
         "env": {
           "GOOGLE_OAUTH_CREDENTIALS": "/path/to/your/gcp-oauth.keys.json"
         }
       }
     }
   }
   

4. 설정 파일을 저장한 뒤 Claude Desktop을 재시작하세요.
5. 캘린더 이벤트 질의 또는 생성을 시도하여 정상적으로 설정되었는지 확인하세요.

API 키 보안

• 위 예시와 같이 환경 변수(GOOGLE_OAUTH_CREDENTIALS)를 사용하세요.

Cursor

저장소에 Cursor용 설치 안내는 제공되지 않습니다.

Cline

저장소에 Cline용 설치 안내는 제공되지 않습니다.

이 MCP를 플로우에서 사용하는 방법

FlowHunt에서 MCP 활용

FlowHunt 워크플로우에 MCP 서버를 통합하려면, 우선 MCP 컴포넌트를 플로우에 추가하고 AI 에이전트와 연결하세요:

MCP 컴포넌트를 클릭해 설정 패널을 여세요. 시스템 MCP 설정 섹션에 아래 JSON 형식으로 MCP 서버 정보를 입력합니다:

{
  "google-calendar": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

설정이 완료되면, AI 에이전트가 해당 MCP의 모든 기능에 접근해 사용할 수 있습니다. “google-calendar"를 실제 MCP 서버 이름으로, URL은 본인의 MCP 서버 주소로 변경하는 것을 잊지 마세요.

개요

의견

Google 캘린더 MCP 서버는 강력한 캘린더 관리 도구와 Claude용 명확한 설정 가이드를 제공합니다. 다만 프롬프트 템플릿, 명확한 MCP 리소스, 타 플랫폼 지원 관련 문서가 부족합니다. AI 에이전트용 Google 캘린더 자동화가 필요하다면 뛰어난 선택이지만, 더 폭넓은 문서화와 리소스 명확화가 있으면 좋겠습니다.

MCP 점수

점수: 6/10 — Claude용 튼튼한 도구와 설정, 하지만 프롬프트·리소스·멀티플랫폼 지원 문서 부족.