mcp-google-gdrive 0.1.0 → 2.0.0

package/README.md

@@ -1,35 +1,104 @@
 # mcp-google-gdrive
 
-An [MCP](https://modelcontextprotocol.io) server for the Google Drive API. Lets AI assistants list, read, create, and manage files in Google Drive with automatic Google Workspace format conversion (Docs to Markdown, Sheets to CSV, Slides to plain text).
+An [MCP](https://modelcontextprotocol.io/) server for Google Drive, Docs, Sheets, and Slides. Lets AI assistants manage files, folders, permissions, labels, and trash with full read/write access across multiple Google accounts. Includes automatic Workspace format conversion (Docs to Markdown, Sheets to CSV/JSON, Slides to text).
 
 ## Tools
 
-| Tool | Description | Status |
-|------|-------------|--------|
-| gdrive_list_files | List and search files with query filtering and pagination | Available |
-| gdrive_get_metadata | Get detailed file metadata by ID | Available |
-| gdrive_read_file | Read file content with automatic Workspace format conversion | Available |
-| gdrive_create_file | Create a new file with content | Available |
-| gdrive_create_folder | Create a new folder | Available |
-| gdrive_update_file | Update existing file content | Planned |
-| gdrive_delete_file | Trash or permanently delete a file | Planned |
-| gdrive_move_file | Move a file between folders | Planned |
-| gdrive_copy_file | Copy a file with optional rename | Planned |
-| gdrive_export_doc | Export Google Doc to Markdown, HTML, or PDF | Planned |
-| gdrive_export_sheet | Export Google Sheet to CSV or JSON | Planned |
-| gdrive_export_slides | Export Google Slides to text or PDF | Planned |
-| gdrive_create_doc | Create a Google Doc from Markdown | Planned |
-| gdrive_update_doc | Update a Google Doc with Markdown content | Planned |
+### Account Management
+
+| Tool | Description |
+|------|-------------|
+| `gdrive_list_accounts` | List all configured Google accounts with labels and emails |
+| `gdrive_switch_account` | Set the active account for subsequent calls |
+| `gdrive_add_account` | Generate an authorization URL to add a new Google account |
+
+### Files
+
+| Tool | Description |
+|------|-------------|
+| `gdrive_list_files` | List files with optional search query and folder filtering |
+| `gdrive_get_metadata` | Get detailed metadata for a file by ID |
+| `gdrive_read_file` | Read file content with automatic Workspace format conversion |
+| `gdrive_create_file` | Create a new file with optional OCR on image/PDF uploads |
+| `gdrive_update_file` | Update a file's content, name, or description |
+| `gdrive_copy_file` | Copy a file, optionally to a different folder |
+| `gdrive_move_file` | Move a file to a different folder |
+| `gdrive_search_files` | Full-text search across file names and content |
+
+### Folders
+
+| Tool | Description |
+|------|-------------|
+| `gdrive_create_folder` | Create a new folder |
+| `gdrive_list_folder` | List contents of a specific folder |
+| `gdrive_delete_folder` | Delete a folder (trash or permanent) |
+
+### Trash
+
+| Tool | Description |
+|------|-------------|
+| `gdrive_trash_file` | Move a file or folder to trash |
+| `gdrive_untrash_file` | Restore a file or folder from trash |
+| `gdrive_empty_trash` | Permanently delete all trashed files (irreversible) |
+| `gdrive_list_trash` | List files currently in trash |
+
+### Permissions
+
+| Tool | Description |
+|------|-------------|
+| `gdrive_share_file` | Share a file with a user, group, domain, or anyone |
+| `gdrive_list_permissions` | List all permissions on a file or folder |
+| `gdrive_update_permission` | Update a permission's role |
+| `gdrive_remove_permission` | Remove a permission (unshare) |
+| `gdrive_transfer_ownership` | Transfer file ownership to another user |
+
+### Labels
+
+| Tool | Description |
+|------|-------------|
+| `gdrive_list_labels` | List available Drive labels |
+| `gdrive_list_file_labels` | List labels applied to a file |
+| `gdrive_set_file_labels` | Add, update, or remove labels on a file |
+
+### Google Docs
+
+| Tool | Description |
+|------|-------------|
+| `gdrive_export_doc` | Export a Google Doc (markdown, html, text, docx, pdf) |
+| `gdrive_create_doc` | Create a Google Doc from Markdown content |
+| `gdrive_update_doc` | Replace a Google Doc's content with Markdown |
+
+### Google Sheets
+
+| Tool | Description |
+|------|-------------|
+| `gdrive_create_sheet` | Create a new spreadsheet with named tabs |
+| `gdrive_export_sheet` | Export a sheet to CSV, JSON, or XLSX |
+| `gdrive_list_sheets` | List all sheets/tabs in a spreadsheet |
+| `gdrive_read_sheet_range` | Read a specific range from any tab (A1 notation) |
+| `gdrive_write_sheet_range` | Write data to a specific range |
+
+### Google Slides
+
+| Tool | Description |
+|------|-------------|
+| `gdrive_create_slides` | Create a new presentation |
+| `gdrive_export_slides` | Export slides to text, PDF, or PPTX |
+| `gdrive_get_slide_thumbnail` | Get a thumbnail image URL for a specific slide |
 
 ## Prerequisites
 
-- Node.js 18 or later
-- A Google Cloud project with the Google Drive API enabled
+- Node.js 18+
+- A Google Cloud project with these APIs enabled:
+  - Google Drive API
+  - Google Docs API
+  - Google Sheets API
+  - Google Slides API
 - OAuth2 desktop application credentials
 
 ## Setup
 
-1. Create a project in the [Google Cloud Console](https://console.cloud.google.com/) and enable the Google Drive API
+1. Create a project in the [Google Cloud Console](https://console.cloud.google.com/) and enable the Drive, Docs, Sheets, and Slides APIs
 2. Create OAuth2 credentials (Application type: Desktop app) and download the JSON file
 3. Save the credentials file:
 
@@ -42,21 +111,32 @@ chmod 600 ~/.config/mcp-google-gdrive/credentials.json
 4. Run the one-time authorization flow:
 
 ```bash
-npx mcp-google-gdrive --auth
+npx mcp-google-gdrive --auth primary
 ```
 
-This opens a URL for Google consent. After granting access, paste the authorization code back into the terminal. The token is saved to `~/.config/mcp-google-gdrive/token.json`.
+This prints a URL for Google consent. After granting access, paste the authorization code back into the terminal.
+
+### Multi-Account Setup
+
+Add additional accounts with unique labels:
+
+```bash
+npx mcp-google-gdrive --auth work
+npx mcp-google-gdrive --auth personal
+```
+
+Each account gets its own token file at `~/.config/mcp-google-gdrive/tokens/{label}.json`. Use the `account` parameter on any tool to specify which account to use, or call `gdrive_switch_account` to change the default.
 
 ## Configuration
 
-### Claude Code
+### Gemini CLI
 
-Add to `~/.claude/settings.json`:
+Add to `~/.gemini/settings.json`:
 
 ```json
 {
   "mcpServers": {
-    "google-drive": {
+    "google-gdrive": {
       "command": "npx",
       "args": ["-y", "mcp-google-gdrive"]
     }
@@ -64,29 +144,31 @@ Add to `~/.claude/settings.json`:
 }
 ```
 
-### VS Code / Cursor
+### watsonx Orchestrate
 
-Add to `.vscode/mcp.json`:
+```bash
+orchestrate toolkits import --kind mcp \
+  --name google-gdrive \
+  --description "Google Drive, Docs, Sheets, Slides" \
+  --command "npx -y mcp-google-gdrive" \
+  --tools "*"
+```
 
-```json
-{
-  "servers": {
-    "google-drive": {
-      "command": "npx",
-      "args": ["-y", "mcp-google-gdrive"]
-    }
-  }
-}
+### Claude Code
+
+```bash
+claude mcp add -s user google-gdrive -- npx -y mcp-google-gdrive
 ```
 
-### Gemini CLI
+### VS Code / Cursor
 
-Add to `~/.gemini/settings.json`:
+Add to `.vscode/mcp.json` in your workspace:
 
 ```json
 {
   "mcpServers": {
-    "google-drive": {
+    "google-gdrive": {
+      "type": "stdio",
       "command": "npx",
       "args": ["-y", "mcp-google-gdrive"]
     }
@@ -96,9 +178,25 @@ Add to `~/.gemini/settings.json`:
 
 ## Authentication
 
-The server uses OAuth2 for Google Drive access. On first run with `--auth`, it generates an authorization URL for browser-based consent. After authorization, tokens are stored locally at `~/.config/mcp-google-gdrive/token.json` with restricted file permissions (0600).
+The server uses OAuth2 for Google Drive access. Credentials are stored locally:
+
+- `~/.config/mcp-google-gdrive/credentials.json` — OAuth2 client (shared across accounts)
+- `~/.config/mcp-google-gdrive/tokens/{label}.json` — Per-account tokens (chmod 600)
+- `~/.config/mcp-google-gdrive/config.json` — Active account and account registry
+
+Access tokens expire after one hour and are refreshed automatically using stored refresh tokens. Token refresh is transparent and requires no user interaction.
+
+### Migrating from v0.x
+
+If upgrading from a single-account v0.x installation, the server automatically migrates your existing `token.json` to `tokens/primary.json` on first start.
+
+## Related MCP Servers
 
-Access tokens expire after one hour and are refreshed automatically using the stored refresh token. Token refresh is transparent and requires no user interaction.
+- [mcp-redhat-account](https://github.com/sleepytimeshon/mcp-redhat-account) - Red Hat account management
+- [mcp-redhat-knowledge](https://github.com/sleepytimeshon/mcp-redhat-knowledge) - Red Hat Knowledge Base search
+- [mcp-redhat-manpage](https://github.com/sleepytimeshon/mcp-redhat-manpage) - RHEL man pages
+- [mcp-redhat-subscription](https://github.com/sleepytimeshon/mcp-redhat-subscription) - Subscription management
+- [mcp-redhat-support](https://github.com/sleepytimeshon/mcp-redhat-support) - Support case management
 
 ## License
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcp-google-gdrive",
-  "version": "0.1.0",
-  "description": "MCP server for Google Drive API with full file management and Workspace format conversion",
+  "version": "2.0.0",
+  "description": "MCP server for Google Drive, Docs, Sheets, and Slides with multi-account support, permissions, labels, and full CRUD",
   "type": "module",
   "bin": {
     "mcp-google-gdrive": "./src/index.js"
@@ -14,8 +14,12 @@
   "keywords": [
     "mcp",
     "google-drive",
+    "google-docs",
+    "google-sheets",
+    "google-slides",
     "google-workspace",
-    "file-management"
+    "file-management",
+    "multi-account"
   ],
   "license": "MIT",
   "repository": {