gws-mcp-server

Google Workspace CLI (gws) 작업을 Model Context Protocol 도구로 노출하는 MCP 서버입니다.

왜 필요한가요?

gws CLI에는 내장 MCP 서버가 있었으나 v0.8.0에서 제거되었습니다. 200~400개의 도구를 노출하여 MCP 클라이언트의 컨텍스트 윈도우 비대화를 유발했기 때문입니다. 이 서버는 선별적인 접근 방식을 취합니다. 노출할 Google 서비스를 선택할 수 있으며, 가치가 높고 범위가 좁은 핵심 작업 세트만 도구로 등록됩니다.

사전 요구 사항

• Node.js 18+ 버전

• gws CLI 설치 및 인증 완료 (npm install -g @googleworkspace/cli && gws auth login)

빠른 시작

# Install
npm install -g gws-mcp-server

# Or run from source
git clone https://github.com/conorbronsdon/gws-mcp-server.git
cd gws-mcp-server
npm install && npm run build

구성

Claude Code (.mcp.json)

{
  "mcpServers": {
    "google-workspace": {
      "command": "npx",
      "args": [
        "gws-mcp-server",
        "--services", "drive,sheets,calendar,docs,gmail"
      ]
    }
  }
}

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "google-workspace": {
      "command": "npx",
      "args": [
        "gws-mcp-server",
        "--services", "drive,sheets,calendar"
      ]
    }
  }
}

옵션

사용 가능한 서비스 및 도구

drive (8개 도구)

• drive_files_list — 파일 검색 및 목록 조회

• drive_files_get — 파일 메타데이터 가져오기

• drive_files_create — 파일 생성 (업로드 옵션 포함)

• drive_files_copy — 파일 복사 (형식 변환에 유용)

• drive_files_update — 파일 메타데이터/콘텐츠 업데이트

• drive_files_delete — 파일 삭제

• drive_files_export — Google Workspace 파일(Doc, Sheet, Slide)을 다른 형식으로 내보내기

• drive_permissions_create — 파일 공유

sheets (4개 도구)

• sheets_get — 스프레드시트 메타데이터 가져오기

• sheets_values_get — 셀 값 읽기

• sheets_values_update — 셀 값 쓰기

• sheets_values_append — 행 추가

calendar (5개 도구)

• calendar_events_list — 이벤트 목록 조회

• calendar_events_get — 이벤트 세부 정보 가져오기

• calendar_events_insert — 이벤트 생성

• calendar_events_update — 이벤트 업데이트

• calendar_events_delete — 이벤트 삭제

docs (3개 도구)

• docs_get — 문서 콘텐츠 가져오기

• docs_create — 문서 생성

• docs_batchUpdate — 문서 업데이트 적용

gmail (4개 도구)

• gmail_messages_list — 메시지 검색

• gmail_messages_get — 메시지 읽기

• gmail_threads_list — 스레드 검색

• gmail_threads_get — 전체 스레드 읽기

총: 24개 도구 (이전 구현의 200-400개 대비)

새 도구 추가

src/services.ts를 편집하여 도구 정의를 추가하세요. 각 도구는 gws CLI 명령에 직접 매핑됩니다:

{
  name: "drive_files_list",           // MCP tool name
  description: "List files in Drive", // Shown to AI
  command: ["drive", "files", "list"],// gws CLI args
  params: [                           // Maps to --params JSON
    { name: "q", description: "Search query", type: "string", required: false },
  ],
  bodyParams: [                       // Maps to --json body
    { name: "name", description: "File name", type: "string", required: true },
  ],
}

아키텍처

MCP Client (Claude) ←→ stdio ←→ gws-mcp-server ←→ gws CLI ←→ Google APIs

이 서버는 얇은 래퍼(wrapper)입니다. MCP 도구 호출을 gws CLI 호출로 변환하고, 필요에 따라 --params 및 --json을 전달하며, JSON 출력을 반환합니다.

면책 조항

이 계정에서 표현된 모든 견해, 의견 및 진술은 전적으로 본인의 것이며 개인적인 자격으로 작성되었습니다. 이는 Modular의 견해, 입장 또는 정책을 반영하지 않으며 그렇게 해석되어서도 안 됩니다. 이 계정은 Modular와 어떠한 방식으로도 제휴, 승인 또는 보증되지 않습니다.

라이선스

MIT