MCP 클라이언트를 하나의 자체 호스팅 서버를 통해 구글 드라이브, 문서, 시트, 슬라이드, 캘린더에 연결하세요. 파일 검색 및 정리, Workspace 콘텐츠 생성 및 편집, 공유 관리, 다단계 워크플로우 자동화 및 모든 통화에 사용되는 구글 신원과 자격 증명을 통제할 수 있습니다.

왜 이 서버인가

• 드라이브 우선 워크플로우: 130개의 도구는 파일 관리, 공유 드라이브, 권한, 수정, 풍부한 문서 편집, 시트 서식, 슬라이드 저작, 캘린더 이벤트를 포함합니다.
• **로컬 또는 호스팅 서비스: ** 개인 데스크톱 클라이언트에는 stdio를, 호스팅 통합에는 Streamable HTTP, 공유 서비스에는 OAuth 보호 팀 모드를 사용하세요.
• 신원 제어: 로컬 OAuth는 여러 Google 계정과 도구별 계정 선택을 지원합니다; 서비스 계정과 외부에서 관리하는 OAuth 토큰도 지원합니다.
• 에이전트 친화적 접근: 도구는 타겟 작업을 노출하며, 선택적 gdrive:/// 자원 인터페이스는 직접 읽기 및 발견을 지원합니다.
• 오픈 및 셀프 호스팅: 자격 증명과 토큰은 귀하가 운영하는 환경에 남아 있습니다.

이 프로젝트는 모든 구글 워크스페이스 API를 공개하려는 시도보다는 딥 드라이브와 에디터 워크플로우에 집중하고 있습니다.

Google Drive MCP Server

Connect an MCP client to Google Drive, Docs, Sheets, Slides, and Calendar through one self-hosted server. Search and organize files, create and edit Workspace content, manage sharing, and automate multi-step workflows while keeping control of the Google identity and credentials used for every call.

Why this server

• Drive-first workflows: 130 tools cover file management, Shared Drives, permissions, revisions, rich Docs editing, Sheets formatting, Slides authoring, and Calendar events.
• Local or hosted: use stdio for a personal desktop client, Streamable HTTP for a hosted integration, or OAuth-protected team mode for a shared service.
• Identity control: local OAuth supports multiple Google accounts and per-tool account selection; service accounts and externally managed OAuth tokens are also supported.
• Agent-friendly access: tools expose targeted operations, while the optional gdrive:/// resource interface supports direct reading and discovery.
• Open and self-hosted: credentials and tokens stay in the environment you operate.

This project remains focused on deep Drive and editor workflows rather than attempting to expose every Google Workspace API.

Client compatibility

Compatibility is determined by the transport and authentication flow a client supports.

See Client configuration for configuration examples and transport requirements.

Quick start

1. Create Google OAuth credentials

In a Google Cloud project:

1. Enable the Drive, Docs, Sheets, Slides, and Calendar APIs.
2. Configure the OAuth consent screen and add your Google account as a test user when the app is in testing.
3. Create an OAuth client with application type Desktop app.
4. Download the JSON file and save it as:

~/.config/google-drive-mcp/gcp-oauth.keys.json

The setup guide has the complete Google Cloud walkthrough and alternative credential locations.

2. Authenticate

npx -y @piotr-agier/google-drive-mcp auth

Complete the Google consent flow in the browser. Tokens are stored by default at ~/.config/google-drive-mcp/tokens.json.

3. Add the server to your MCP client

For clients that use the common mcpServers configuration shape:

{
  "mcpServers": {
    "google-drive": {
      "command": "npx",
      "args": ["-y", "@piotr-agier/google-drive-mcp"]
    }
  }
}