Google MCP

by vakharwalad23
Verified

Google MCP 도구

이는 Claude나 Cursor와 같은 AI 클라이언트와 완벽하게 통합되도록 설계된 MCP 프로토콜을 위한 Google 기본 도구(예: Gmail, 캘린더) 모음입니다.

지엑스피1

특징

  • 지메일:
    • 여러 수신자(받는 사람, 참조, 숨은 참조)와 첨부 파일을 포함한 이메일을 보냅니다.
    • 사용자 정의 쿼리, 레이블 및 결과 제한을 사용하여 이메일을 나열합니다.
    • ID로 특정 이메일을 읽어보세요.
    • 라벨을 관리합니다(추가, 제거, 나열).
    • 이메일을 초안하고 삭제합니다.
  • 달력:
    • 달력을 나열하고 기본 달력을 설정합니다.
    • 세부 정보(요약, 시작/종료 시간, 참석자 등)를 입력하여 이벤트를 만듭니다.
    • 사용자 정의 필터를 사용하여 다가올 이벤트를 나열하세요.
    • 기존 이벤트를 업데이트하거나 삭제합니다.
    • 일정을 잡기 위한 여유 시간대를 찾으세요.
  • 운전하다:
    • 검색어로 필터링
    • 수정 날짜 또는 기타 기준으로 정렬
    • 표시 개수 사용자 정의
    • 자세한 파일 메타데이터 보기
    • 파일 콘텐츠(텍스트, 문서, 스프레드시트) 읽기
    • 지정된 콘텐츠로 새 파일을 만듭니다.
    • 기존 파일 업데이트
    • 파일 삭제(휴지통 또는 영구)
    • 특정 권한으로 파일 공유
  • 작업:
    • 모든 작업 목록 보기
    • 새로운 작업 목록 만들기
    • 기존 작업 목록 삭제
    • 기본 작업 목록 설정
    • 필터를 사용하여 작업 나열
    • 작업 세부 정보 보기
    • 제목, 메모, 마감일을 사용하여 작업 만들기
    • 작업 속성 업데이트
    • 작업을 완료로 표시
    • 작업 삭제
  • TODO 계획:
    • Google 연락처: 연락처를 검색하고 관리하세요.
    • 그리고 더 많은 것들...

워크플로에 대한 명령을 연결할 수 있습니다. 예:

"읽지 않은 이메일을 나열하고, 가장 최근 이메일에 대한 답장을 작성하고, 내일 오후 2시에 후속 회의를 예약하세요."

수동 설치

  1. 필수 조건:
    • Bun 설치:
    brew install oven-sh/bun/bun # macOS/Linux with Homebrew
  2. OAuth 설정:
    • Google Cloud Console 에서 Google Cloud 프로젝트를 만듭니다.
    • OAuth 2.0 자격 증명(클라이언트 ID, 클라이언트 비밀번호)을 설정합니다.
    • 데스크톱 앱 유형을 선택하세요.
    • 테스트 모드를 사용하는 경우 테스트 사용자 목록에 이메일을 추가하세요.
    • 원하는 서비스(Gmail, 캘린더, 드라이브 등)에 대한 API 액세스를 활성화하세요.
  3. 클라이언트 구성: claude_desktop_config.json(또는 클라이언트에 대한 동등한 구성 파일)을 편집하세요.
{ "mcpServers": { "google-mcp": { "command": "bunx", "args": ["--no-cache", "google-mcp@latest"], "env": { // Either can be used, but not both // Use OAuth "GOOGLE_OAUTH_CLIENT_ID": "<YOUR_CLIENT_ID>", "GOOGLE_OAUTH_CLIENT_SECRET": "<YOUR_CLIENT_SECRET>", "GOOGLE_OAUTH_TOKEN_PATH": "<PATH_TO_STORE_TOKENS>", // Use Service Account "GOOGLE_CLIENT_EMAIL": "<YOUR_SERVICE_ACCOUNT_EMAIL>", "GOOGLE_PRIVATE_KEY": "<YOUR_SERVICE_ACCOUNT_PRIVATE_KEY>", "GMAIL_USER_TO_IMPERSONATE": "<USER_TO_IMPERSONATE>" } } } }
  1. 인증:
    • 서버를 처음 실행하면 OAuth 인증을 위한 브라우저가 열립니다. 안내에 따라 액세스 권한을 부여하면 토큰이 GOOGLE_OAUTH_TOKEN_PATH에 저장됩니다.

용법

이제 Claude에게 google-mcp 도구를 사용하라고 요청해 보세요.

Send an email to jane.doe@example.com with the subject "Meeting Notes" and body "Here are the notes from today."
List my upcoming calendar events for the next 3 days.
Create a calendar event titled "Team Sync" tomorrow at 10 AM for 1 hour.

지역 개발

git clone https://github.com/vakharwalad23/google-mcp.git cd google-mcp bun install bun run index.ts

Google MCP 도구를 사용해 주셔서 감사합니다! 질문이나 제안 사항이 있으시면 언제든지 이슈를 개설하거나 프로젝트에 참여해 주세요.

도구를 이용해 놀아보며 즐겨보세요!!

-
security - not tested
-
license - not tested
-
quality - not tested

이는 Claude나 Cursor와 같은 AI 클라이언트와 완벽하게 통합되도록 설계된 MCP 프로토콜을 위한 Google 기본 도구(예: Gmail, 캘린더) 모음입니다.

  1. Features
    1. Manual Installation
  2. Usage
    1. Local Development
      ID: opwf6bop3j