mcp-google-gdrive

Google Drive, Docs, Sheets 및 Slides를 위한 MCP 서버입니다. AI 어시스턴트가 여러 Google 계정에 걸쳐 파일, 폴더, 권한, 라벨 및 휴지통을 읽기/쓰기 권한으로 완전히 관리할 수 있게 합니다. Workspace 형식 자동 변환(Docs를 Markdown으로, Sheets를 CSV/JSON으로, Slides를 텍스트로) 기능을 포함합니다.

도구

계정 관리

파일

폴더

휴지통

권한

라벨

Google Docs

Google Sheets

Google Slides

v2.2 새로운 기능

• outputFormat 매개변수 — 12개의 읽기/나열 도구가 이제 outputFormat: "json" | "yaml" | "text"를 허용합니다. 기본값은 json입니다(이전 버전과 호환). 구조화된 출력에는 yaml을, 읽기 쉬운 간결한 표 형식에는 text를 사용하세요. 지원 도구: list_accounts, list_files, list_folder, list_trash, list_permissions, list_labels, list_file_labels, list_sheets, get_metadata, read_sheet_range, get_slide_thumbnail, search_files.

v2.1

• gdrive_download_file — Drive의 모든 파일을 로컬 디스크 경로로 다운로드합니다. Workspace 파일(Docs, Sheets, Slides)은 지정된 형식(pdf, docx, xlsx, pptx, csv, txt, html 또는 markdown)으로 자동 내보내집니다.

• 내보내기 도구의 savePath — gdrive_export_doc, gdrive_export_sheet 및 gdrive_export_slides는 이제 선택적 savePath 매개변수를 허용합니다. 제공 시 바이너리 내보내기(docx, pdf, xlsx, pptx)가 base64로 반환되는 대신 디스크에 저장됩니다. savePath를 생략하면 v2.0 동작이 유지됩니다.

• gdrive_list_accounts 이메일 확인 — 이메일 주소 대신 "migrated"로 표시되던 v0.x에서 마이그레이션된 계정은 첫 호출 시 Google userinfo API를 통해 자동으로 확인됩니다.

• 문서 수정 — gdrive_empty_trash는 최종 일관성에 대해 언급하며, gdrive_transfer_ownership은 조직 간 제한 사항을 언급합니다.

출력 형식

모든 읽기 및 나열 도구는 outputFormat 매개변수를 지원합니다:

예시: gdrive_list_files({ query: "name contains 'report'", outputFormat: "text" }) 결과:

files:
  id             name              mimeType         modifiedTime  size
  -------------  ----------------  ---------------  ------------  ----
  abc123def456   Q1 Report.pdf     application/pdf  2026-04-01    1024
  ghi789jkl012   Q2 Report.docx    application/pdf  2026-03-15    2048
resultCount: 2

사전 요구 사항

• Node.js 18+

• 다음 API가 활성화된 Google Cloud 프로젝트:

  • Google Drive API

  • Google Docs API

  • Google Sheets API

  • Google Slides API

• OAuth2 데스크톱 애플리케이션 자격 증명

설정

1. Google Cloud Console에서 프로젝트를 생성하고 Drive, Docs, Sheets 및 Slides API를 활성화합니다.

2. OAuth2 자격 증명(애플리케이션 유형: 데스크톱 앱)을 생성하고 JSON 파일을 다운로드합니다.

3. 자격 증명 파일을 저장합니다:

mkdir -p ~/.config/mcp-google-gdrive
cp ~/Downloads/client_secret_*.json ~/.config/mcp-google-gdrive/credentials.json
chmod 600 ~/.config/mcp-google-gdrive/credentials.json

4. 일회성 인증 흐름을 실행합니다:

npx mcp-google-gdrive --auth primary

이 명령은 Google 동의를 위한 URL을 출력합니다. 액세스 권한을 부여한 후, 인증 코드를 터미널에 다시 붙여넣으세요.

다중 계정 설정

고유한 라벨을 사용하여 추가 계정을 등록합니다:

npx mcp-google-gdrive --auth work
npx mcp-google-gdrive --auth personal

각 계정은 ~/.config/mcp-google-gdrive/tokens/{label}.json에 자체 토큰 파일을 가집니다. 도구에서 account 매개변수를 사용하여 사용할 계정을 지정하거나, gdrive_switch_account를 호출하여 기본값을 변경하세요.

구성

Gemini CLI

~/.gemini/settings.json에 추가:

{
  "mcpServers": {
    "google-gdrive": {
      "command": "npx",
      "args": ["-y", "mcp-google-gdrive"]
    }
  }
}

watsonx Orchestrate

orchestrate toolkits import --kind mcp \
  --name google-gdrive \
  --description "Google Drive, Docs, Sheets, Slides" \
  --command "npx -y mcp-google-gdrive" \
  --tools "*"

Claude Code

claude mcp add -s user google-gdrive -- npx -y mcp-google-gdrive

VS Code / Cursor

워크스페이스의 .vscode/mcp.json에 추가:

{
  "mcpServers": {
    "google-gdrive": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-gdrive"]
    }
  }
}

인증

이 서버는 Google Drive 액세스를 위해 OAuth2를 사용합니다. 자격 증명은 로컬에 저장됩니다:

• ~/.config/mcp-google-gdrive/credentials.json — OAuth2 클라이언트 (계정 간 공유)

• ~/.config/mcp-google-gdrive/tokens/{label}.json — 계정별 토큰 (chmod 600)

• ~/.config/mcp-google-gdrive/config.json — 활성 계정 및 계정 레지스트리

액세스 토큰은 1시간 후에 만료되며 저장된 새로 고침 토큰을 사용하여 자동으로 갱신됩니다. 토큰 갱신은 투명하게 이루어지며 사용자 상호 작용이 필요하지 않습니다.

v0.x에서 마이그레이션

단일 계정 v0.x 설치에서 업그레이드하는 경우, 서버는 첫 시작 시 기존 token.json을 tokens/primary.json으로 자동 마이그레이션합니다.

관련 MCP 서버

• mcp-redhat-account - Red Hat 계정 관리

• mcp-redhat-knowledge - Red Hat 지식 베이스 검색

• mcp-redhat-manpage - RHEL 매뉴얼 페이지

• mcp-redhat-subscription - 구독 관리

• mcp-redhat-support - 지원 케이스 관리

라이선스

MIT