Repolode
제출하기
taylorwilsdon

taylorwilsdon/google_workspace_mcp

AI 어시스턴트가 Gmail, Calendar, Drive, Docs, Sheets, Slides, Forms, Tasks, Contacts, Chat 등을 제어할 수 있도록 도구를 제공하는 MCP 서버 겸 CLI입니다.

GitHub에서 보기웹사이트
스타
3,483
포크
1,097
열린 이슈
100
마지막 커밋
그저께

어떤 프로젝트인가요?

Workspace MCP는 Google Workspace 서비스를 AI 어시스턴트와 MCP 호환 클라이언트가 사용할 수 있는 도구로 제공하는 Model Context Protocol 서버입니다. Gmail, Google Calendar, Drive, Docs, Sheets, Slides, Forms, Tasks, Contacts, Chat, Custom Search, Apps Script를 지원하며, 전체 도구 수는 120개가 넘습니다. 클라이언트가 필요한 도구만 불러올 수 있도록 도구를 core, extended, complete 티어로 나누고, 서비스나 개별 도구를 활성화하거나 비활성화할 수도 있습니다.

서버는 구형 클라이언트용 stdio를 통한 로컬 실행과 streamable HTTP를 통한 원격 실행을 지원합니다. 다중 사용자 인증을 위한 OAuth 2.1, 읽기 전용 모드, 디스크에 쓸 수 없는 컨테이너를 위한 stateless 모드를 지원합니다. Docker, reverse-proxy 구성, 외부 OAuth 제공자, 도메인 전체 위임을 사용하는 서비스 계정, 선택 가능한 OpenTelemetry tracing 등 다양한 배포 옵션을 제공합니다. 함께 제공되는 `workspace-cli` 도구를 사용하면 캐시된 OAuth 토큰으로 터미널에서 도구 목록을 확인하고 호출할 수 있습니다.

프로젝트는 Python으로 작성되었으며 uvx 또는 PyPI를 통해 설치할 수 있고, MIT 라이선스로 배포됩니다.

핵심 기능

  • 01하나의 MCP 서버에서 12개 Google Workspace 서비스를 지원하며 도구는 120개가 넘습니다.
  • 02OAuth 2.1 다중 사용자 인증과 streamable HTTP 전송을 지원합니다.
  • 03core, extended, complete 도구 티어와 읽기 전용 모드를 제공합니다.
  • 04컨테이너용 stateless 모드와 외부 OAuth 제공자 지원을 포함합니다.
  • 05터미널에서 도구 목록을 확인하고 호출할 수 있는 CLI를 제공합니다.

활용 사례

  • Claude나 ChatGPT가 Gmail 메시지를 검색하고 요약하거나 답장 초안을 작성하도록 할 수 있습니다.
  • AI 클라이언트에서 자연어 프롬프트로 Google Docs나 Sheets를 만들고 편집할 수 있습니다.
  • 사용자별 OAuth를 적용해 조직에서 공유하는 Workspace MCP 엔드포인트를 호스팅할 수 있습니다.
  • CLI를 통해 스크립트에서 캘린더, 작업 또는 양식 워크플로를 자동화할 수 있습니다.

빠른 시작

  1. 1

    Google Cloud Console에서 OAuth 클라이언트를 만들고 사용할 서비스의 Google API를 사용 설정합니다

  2. 2

    환경 변수 GOOGLE_OAUTH_CLIENT_ID와 GOOGLE_OAUTH_CLIENT_SECRET을 설정합니다

  3. 3

    core 도구 티어로 서버를 실행합니다

    uvx workspace-mcp --tool-tier core

사용 전 알아둘 점

  • 사용하려면 직접 Google Cloud OAuth 클라이언트를 만들고 API를 미리 사용 설정해야 합니다.
  • Google Chat을 사용하려면 Chat 앱을 한 번 구성하고 Google Workspace 계정이 있어야 합니다.
  • OAuth 2.1 모드에서는 stdio 대신 HTTP 전송을 사용해야 합니다.

포함된 컬렉션

Claude Code용 MCP 서버Claude Code 도구·스킬·플러그인MCP 서버

토픽

#mcp#google-workspace#gmail#google-calendar#google-drive#llm-tools#claude#ai#chatgpt#claude-code

자주 묻는 질문

google_workspace_mcp은(는) 무엇인가요?
AI 어시스턴트가 Gmail, Calendar, Drive, Docs, Sheets, Slides, Forms, Tasks, Contacts, Chat 등을 제어할 수 있도록 도구를 제공하는 MCP 서버 겸 CLI입니다. Workspace MCP는 Google Workspace 서비스를 AI 어시스턴트와 MCP 호환 클라이언트가 사용할 수 있는 도구로 제공하는 Model Context Protocol 서버입니다. Gmail, Google Calendar, Drive, Docs, Sheets, Slides, Forms, Tasks, Contacts, Chat, Custom Search, Apps Script를 지원하며, 전체 도구 수는 120개가 넘습니다. 클라이언트가 필요한 도구만 불러올 수 있도록 도구를 core, extended, complete 티어로 나누고, 서비스나 개별 도구를 활성화하거나 비활성화할 수도 있습니다.
google_workspace_mcp은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
google_workspace_mcp은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
google_workspace_mcp은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. google_workspace_mcp의 마지막 커밋은 2026년 11월 5일입니다.
google_workspace_mcp은(는) 어디에 사용할 수 있나요?
Claude나 ChatGPT가 Gmail 메시지를 검색하고 요약하거나 답장 초안을 작성하도록 할 수 있습니다. AI 클라이언트에서 자연어 프롬프트로 Google Docs나 Sheets를 만들고 편집할 수 있습니다. 사용자별 OAuth를 적용해 조직에서 공유하는 Workspace MCP 엔드포인트를 호스팅할 수 있습니다. CLI를 통해 스크립트에서 캘린더, 작업 또는 양식 워크플로를 자동화할 수 있습니다.
google_workspace_mcp는 어떻게 설치하나요?
Google Cloud Console에서 OAuth 클라이언트를 만들고 사용할 서비스의 Google API를 사용 설정합니다 환경 변수 GOOGLE_OAUTH_CLIENT_ID와 GOOGLE_OAUTH_CLIENT_SECRET을 설정합니다 core 도구 티어로 서버를 실행합니다: uvx workspace-mcp --tool-tier core
google_workspace_mcp은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/taylorwilsdon/google_workspace_mcp

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트