MCPクライアントをGoogleドライブ、ドキュメント、スプレッドシート、スライド、カレンダーに一つのセルフホストサーバー経由で接続できます。ファイルの検索・整理、ワークスペースコンテンツの作成・編集、共有管理、多段階ワークフローの自動化を行いながら、すべての通話で使うGoogleのアイデンティティと認証情報を管理できます。

なぜこのサーバーなのか

• ドライブファーストのワークフロー: 130のツールはファイル管理、共有ドライブ、権限、修正、リッチドキュメント編集、スプレッドのフォーマット、スライド作成、カレンダーイベントをカバーしています。
• **ローカルまたはホスト:**個人用デスクトップクライアントにはstdio、ホスト統合にはStreamable HTTP、共有サービスにはOAuth保護チームモードを使用。
• **アイデンティティ制御:**ローカルOAuthは複数のGoogleアカウントとツールごとのアカウント選択をサポートしています。サービスアカウントおよび外部管理のOAuthトークンもサポートされています。
• **エージェントフレンドリーアクセス:**ツールはターゲットを絞った操作を公開し、オプションのgdrive:///リソースインターフェースは直接読み取りと発見をサポートします。
• **オープンかつセルフホスト:**認証情報とトークンは運用環境に残ります。

このプロジェクトは、すべてのGoogle Workspace 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"]
    }
  }
}