Подключите MCP-клиент к Google Drive, Docs, Sheets, Slides и Calendar через один самостоятельный сервер. Ищите и организуйте файлы, создавайте и редактируйте контент Workspace, управляйте обменом и автоматизируйте многоступенчатые рабочие процессы, сохраняя при этом контроль над идентификацией Google и учетными данными, используемыми для каждого звонка.

Почему именно этот сервер

• Рабочие процессы с первого привода: 130 инструментов охватывают управление файлами, общие диски, права доступа, ревизии, редактирование богатой документации, форматирование листов, создание слайдов и события календаря.
• Локальный или хостированный: используйте stdio для личного клиента на рабочем столе, Streamable HTTP для хостинговой интеграции или командный режим с защитой OAuth для общего сервиса.
• Контроль идентичности: локальный OAuth поддерживает несколько аккаунтов Google и выбор аккаунта для каждого инструмента; также поддерживаются сервисные аккаунты и внешне управляемые токены OAuth.
• **Агент-дружелюбный доступ: ** инструменты открывают целевые операции, а опциональный интерфейс [gdrive:/// поддерживает прямое чтение и обнаружение.
• Открытые и самостоятельные хостинги: учетные данные и токены остаются в вашей среде.

Этот проект по-прежнему сосредоточен на рабочих процессах Deep Drive и редактора, а не на попытках открыть все API Google Workspace.

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"]
    }
  }
}