Для чего этот сервер?

Этот сервер подключает ИИ-агента к Google Диску: через него можно искать файлы, читать документы и таблицы, обновлять ячейки в Google Sheets. Всё — без ручного копирования и переключения между окнами. Разработчику не нужно писать обёртки для API: сервер сам управляет авторизацией и экспортирует файлы в читаемый формат. Удобно, когда нужно быстро достать данные из рабочего пространства или автоматизировать отчётность.

Что он умеет?

Интегрируется с Google Drive: ищет файлы по запросу с пагинацией, читает их содержимое по ID, экспортирует документы, таблицы, презентации и рисунки в Markdown, CSV, текст и PNG. Работает с Google Sheets: читает данные из таблиц с указанием диапазонов и листов, обновляет значения в отдельных ячейках. Доступ к файлам предоставляет через ресурсы gdrive://.

Каталог MCP
isaacphi/mcp-gdrive

isaacphi/mcp-gdrive

от isaacphi

Ищет и читает файлы в Google Drive, работает с Google Таблицами: обновляет ячейки и выгружает данные. Поддерживает документы, презентации и рисунки, конвертируя их в нужный формат.

Github NPM Сайт сервера

README

4 инструмента

Версии

Установить сервер

Google Drive server

This MCP server integrates with Google Drive to allow listing, reading, and searching files, as well as the ability to read and write to Google Sheets.

This project includes code originally developed by Anthropic, PBC, licensed under the MIT License from this repo.

Components

Tools

gdrive_search
- Description: Search for files in Google Drive.
- Input:
  - query (string): Search query.
  - pageToken (string, optional): Token for the next page of results.
  - pageSize (number, optional): Number of results per page (max 100).
- Output: Returns file names and MIME types of matching files.
gdrive_read_file
- Description: Read contents of a file from Google Drive.
- Input:
  - fileId (string): ID of the file to read.
- Output: Returns the contents of the specified file.
gsheets_read
- Description: Read data from a Google Spreadsheet with flexible options for ranges and formatting.
- Input:
  - spreadsheetId (string): The ID of the spreadsheet to read.
  - ranges (array of strings, optional): Optional array of A1 notation ranges (e.g., ['Sheet1!A1:B10']). If not provided, reads the entire sheet.
  - sheetId (number, optional): Specific sheet ID to read. If not provided with ranges, reads the first sheet.
- Output: Returns the specified data from the spreadsheet.
gsheets_update_cell
- Description: Update a cell value in a Google Spreadsheet.
- Input:
  - fileId (string): ID of the spreadsheet.
  - range (string): Cell range in A1 notation (e.g., 'Sheet1!A1').
  - value (string): New cell value.
- Output: Confirms the updated value in the specified cell.

Часто задаваемые вопросы

Инструменты были проиндексированы: 18.10.2026

gdrive_read_file

Прочитать содержимое файла из Google Drive

Параметры

fileIdstringобязательный
Идентификатор файла для чтения

gdrive_search

Искать файлы в Google Drive

Параметры

pageSizenumber
Количество результатов на странице (максимум 100)
pageTokenstring
Токен для следующей страницы результатов.
querystringобязательный
Поисковый запрос

gsheets_read

Читает данные из Google Spreadsheet с гибкими настройками диапазонов и форматирования.

Параметры

rangesstring[]
Необязательный массив диапазонов в нотации A1, например ['Sheet1!A1:B10']. Если не указан, читает весь лист.
sheetIdnumber
Необязательный идентификатор конкретного листа для чтения. Если не указан вместе с диапазонами, читается первый лист.
spreadsheetIdstringобязательный
Идентификатор электронной таблицы для чтения.

gsheets_update_cell

Обновляет значение ячейки в Google Таблице

Параметры

fileIdstringобязательный
ID электронной таблицы
rangestringобязательный
Диапазон ячеек в нотации A1 (например, 'Sheet1!A1')
valuestringобязательный
Новое значение ячейки

`0.2.0`основная	14.12.2024
`0.1.0`	14.12.2024

Выберите клиент, чтобы установить isaacphi/mcp-gdrive:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "isaacphi-mcp-gdrive-kb1h6uwpcw": {
      "command": "npx",
      "args": [
        "-y",
        "@isaacphi/mcp-gdrive"
      ],
      "env": {
        "CLIENT_ID": "<CLIENT_ID>",
        "CLIENT_SECRET": "<CLIENT_SECRET>",
        "GDRIVE_CREDS_DIR": "/path/to/config/directory"
      }
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "isaacphi-mcp-gdrive-kb1h6uwpcw": {
      "command": "npx",
      "args": [
        "-y",
        "@isaacphi/mcp-gdrive"
      ],
      "env": {
        "CLIENT_ID": "<CLIENT_ID>",
        "CLIENT_SECRET": "<CLIENT_SECRET>",
        "GDRIVE_CREDS_DIR": "/path/to/config/directory"
      }
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "isaacphi-mcp-gdrive-kb1h6uwpcw": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@isaacphi/mcp-gdrive"
      ],
      "env": {
        "CLIENT_ID": "<CLIENT_ID>",
        "CLIENT_SECRET": "<CLIENT_SECRET>",
        "GDRIVE_CREDS_DIR": "/path/to/config/directory"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"isaacphi-mcp-gdrive-kb1h6uwpcw\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@isaacphi/mcp-gdrive\"],\"env\":{\"CLIENT_ID\":\"<CLIENT_ID>\",\"CLIENT_SECRET\":\"<CLIENT_SECRET>\",\"GDRIVE_CREDS_DIR\":\"/path/to/config/directory\"}}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "isaacphi-mcp-gdrive-kb1h6uwpcw": {
      "command": "npx",
      "args": [
        "-y",
        "@isaacphi/mcp-gdrive"
      ],
      "env": {
        "CLIENT_ID": "<CLIENT_ID>",
        "CLIENT_SECRET": "<CLIENT_SECRET>",
        "GDRIVE_CREDS_DIR": "/path/to/config/directory"
      }
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add isaacphi-mcp-gdrive-kb1h6uwpcw --env CLIENT_ID=<CLIENT_ID> --env CLIENT_SECRET=<CLIENT_SECRET> --env GDRIVE_CREDS_DIR=/path/to/config/directory -- npx -y @isaacphi/mcp-gdrive

Либо через JSON-конфиг:

claude mcp add-json isaacphi-mcp-gdrive-kb1h6uwpcw "{\"command\":\"npx\",\"args\":[\"-y\",\"@isaacphi/mcp-gdrive\"],\"env\":{\"CLIENT_ID\":\"<CLIENT_ID>\",\"CLIENT_SECRET\":\"<CLIENT_SECRET>\",\"GDRIVE_CREDS_DIR\":\"/path/to/config/directory\"}}"

Codex

Добавьте сервер командой в терминале:

codex mcp add isaacphi-mcp-gdrive-kb1h6uwpcw --env CLIENT_ID=<CLIENT_ID> --env CLIENT_SECRET=<CLIENT_SECRET> --env GDRIVE_CREDS_DIR=/path/to/config/directory -- npx -y @isaacphi/mcp-gdrive

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.isaacphi-mcp-gdrive-kb1h6uwpcw]
command = "npx"
args = ["-y", "@isaacphi/mcp-gdrive"]

[mcp_servers.isaacphi-mcp-gdrive-kb1h6uwpcw.env]
CLIENT_ID = "<CLIENT_ID>"
CLIENT_SECRET = "<CLIENT_SECRET>"
GDRIVE_CREDS_DIR = "/path/to/config/directory"

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите isaacphi/mcp-gdrive, а в поле команды запуска — строку ниже:

npx -y @isaacphi/mcp-gdrive

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "isaacphi-mcp-gdrive-kb1h6uwpcw": {
      "command": "npx",
      "args": [
        "-y",
        "@isaacphi/mcp-gdrive"
      ],
      "env": {
        "CLIENT_ID": "<CLIENT_ID>",
        "CLIENT_SECRET": "<CLIENT_SECRET>",
        "GDRIVE_CREDS_DIR": "/path/to/config/directory"
      }
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "isaacphi-mcp-gdrive-kb1h6uwpcw": {
      "command": "npx",
      "args": [
        "-y",
        "@isaacphi/mcp-gdrive"
      ],
      "env": {
        "CLIENT_ID": "<CLIENT_ID>",
        "CLIENT_SECRET": "<CLIENT_SECRET>",
        "GDRIVE_CREDS_DIR": "/path/to/config/directory"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например isaacphi-mcp-gdrive-kb1h6uwpcw.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: isaacphi-mcp-gdrive-kb1h6uwpcw
    command: npx
    args:
      - "-y"
      - "@isaacphi/mcp-gdrive"
    env:
      CLIENT_ID: <CLIENT_ID>
      CLIENT_SECRET: <CLIENT_SECRET>
      GDRIVE_CREDS_DIR: /path/to/config/directory

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "isaacphi-mcp-gdrive-kb1h6uwpcw": {
      "command": "npx",
      "args": [
        "-y",
        "@isaacphi/mcp-gdrive"
      ],
      "env": {
        "CLIENT_ID": "<CLIENT_ID>",
        "CLIENT_SECRET": "<CLIENT_SECRET>",
        "GDRIVE_CREDS_DIR": "/path/to/config/directory"
      }
    }
  }
}

Конфиг для установки сервера

{
  "command": "npx",
  "args": [
    "-y",
    "@isaacphi/mcp-gdrive"
  ],
  "env": {
    "CLIENT_ID": "<CLIENT_ID>",
    "CLIENT_SECRET": "<CLIENT_SECRET>",
    "GDRIVE_CREDS_DIR": "/path/to/config/directory"
  }
}

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx