README.md•8.47 kB
[](https://smithery.ai/server/@rishipradeep-think41/google-drive-mcp)
# Google Drive MCP Server
Google Drive MCP Server is a stateless server that integrates Google Drive functionalities with the Model Context Protocol (MCP). It provides a suite of tools and resources to interact with Google Drive, enabling operations like file management, content retrieval, and permission handling through a standardized interface.
## 🚀 Features
- **Root Listing:** List top-level locations like "My Drive" and "Shared with me" using `drive_roots`.
- **Folder Browsing:** List contents of any folder with `drive_folder_children`.
- **File Metadata:** Retrieve detailed metadata for a file using `drive_file_metadata`.
- **File Exporting:** Retrieve raw file content using `drive_file_content` (note: no built-in format conversion).
- **File Uploading:** Create or update files with content using `drive_upload`.
- **Text Appending:** Append plain text to existing text files using `drive_append_text`.
- **File Deletion & Trash:** Move files to trash or delete them permanently with `drive_delete` and `drive_file_empty_trash`.
- **Permission Management:** Add, update, remove, or list permissions for files/folders via `drive_share`, `drive_permission_update`, `drive_permission_delete`, etc.
- **Commenting & Replies:** Add comments, reply to them, and list/delete comments or replies using tools like `drive_comment`, `drive_file_list_comments`, and related tools.
- **Change Tracking:** Track changes in a user's Drive using `drive_changes`.
- **File Search:** Search for files by name or other criteria using `drive_search`.
🛠️ **Installation**
1. **Clone the Repository:**
```bash
git clone [https://github.com/rishipradeep-think41/google-drive-mcp.git](https://github.com/rishipradeep-think41/google-drive-mcp.git)
cd google-drive-mcp
```
2. **Install Dependencies:**
```bash
npm install
```
3. **Configure Environment Variables:**
Create a `.env` file in the root directory and add the following:
```env
CLIENT_ID=your_google_client_id
CLIENT_SECRET=your_google_client_secret
REFRESH_TOKEN=your_google_refresh_token
PORT=8081
```
Ensure you have a valid Google OAuth2 client and refresh token with appropriate Drive API scopes.
4. **Start the Server:**
```bash
node index.js
```
The server will start on `http://localhost:8081`.
📚 **API Overview**
**Resources**
- `drive_roots`: Lists files in "My Drive" and "Shared with me".
## Tool Categories
### Basic Navigation & Information
| Tool Name | Description |
| ------------------------- | ------------------------------------------ |
| `drive_roots` | List roots (My Drive, Shared with me) |
| `drive_changes` | List changes in Drive |
| `drive_file_metadata` | Get metadata of a file |
| `drive_folder_children` | List contents of a folder |
| `drive_search` | Search files in Google Drive |
| `drive_storage_quota` | Get storage quota information for the user |
| `drive_storage_breakdown` | Get storage usage breakdown by file type |
### File Content Operations
| Tool Name | Description |
| -------------------- | --------------------------------------------------- |
| `drive_file_content` | Retrieve content of a Google Drive file |
| `drive_create` | Create file or folder |
| `drive_upload` | Upload or update file content |
| `drive_append_text` | Append plain text to an existing text file in Drive |
### File Management
| Tool Name | Description |
| ------------------------ | -------------------------------------------------- |
| `drive_copy` | Copy a file or folder to a new location |
| `drive_move` | Move a file or folder to a different parent folder |
| `drive_rename` | Rename a file or folder |
| `drive_delete` | Trash or delete a file |
| `drive_restore` | Restore a file from the trash |
| `drive_file_empty_trash` | Permanently delete all trashed files |
| `drive_star` | Star or unstar a file or folder |
| `drive_file_lock` | Lock or unlock a file to prevent changes |
| `drive_shortcut_create` | Create a shortcut to a file or folder |
### File Version Management
| Tool Name | Description |
| ----------------------- | ----------------------------------- |
| `drive_versions_list` | List all versions of a file |
| `drive_versions_delete` | Delete a specific version of a file |
### Permissions & Sharing
| Tool Name | Description |
| ----------------------------- | ----------------------------------------------------- |
| `drive_share` | Manage file permissions |
| `drive_permissions_list` | List all permissions of a file or folder |
| `drive_permission_update` | Update a user's permission on a file or folder |
| `drive_permission_delete` | Remove a user's access from a file or folder |
| `drive_permission_add_domain` | Share file or folder with everyone in a domain |
| `drive_permission_add_anyone` | Allow anyone with the link to access a file or folder |
### Comments & Collaboration
| Tool Name | Description |
| ----------------------------- | ----------------------------- |
| `drive_comment` | Add a comment to a file |
| `drive_file_list_comments` | List all comments on a file |
| `drive_file_delete_comment` | Delete a comment from a file |
| `drive_file_reply_to_comment` | Reply to a comment on a file |
| `drive_file_list_replies` | List all replies to a comment |
| `drive_file_delete_reply` | Delete a reply to a comment |
### Shared Drives (Team Drives)
| Tool Name | Description |
| --------------------------- | ---------------------------------------- |
| `drive_shared_drives_list` | List all accessible Shared Drives |
| `drive_shared_drive_get` | Get metadata for a specific Shared Drive |
| `drive_shared_drive_create` | Create a new Shared Drive |
| `drive_shared_drive_delete` | Delete a Shared Drive |
| `drive_shared_drive_update` | Update a Shared Drive's metadata |
| `drive_shared_drive_files` | List files in a Shared Drive |
### Batch Operations
| Tool Name | Description |
| -------------------------------- | --------------------------------------------------- |
| `drive_batch_get_metadata` | Get metadata for multiple files in a single request |
| `drive_batch_update_permissions` | Update permissions for multiple files at once |
| `drive_batch_delete` | Delete multiple files or folders at once |
| `drive_batch_copy` | Copy multiple files to a destination folder |
| `drive_batch_move` | Move multiple files to a destination folder |
🔐 **Authentication**
The server uses OAuth2 for authentication with Google Drive. Ensure that the `CLIENT_ID`, `CLIENT_SECRET`, and `REFRESH_TOKEN` are correctly set in the `.env` file. These credentials should have the necessary scopes to access and modify files in Google Drive.
🧪 **Testing**
You can test the endpoints using tools like MCPInspector. Ensure the server is running at `http://localhost:${port}`.
🤝 **Contributing**
Contributions are welcome! Please fork the repository and submit a pull request for any enhancements or bug fixes.
📄 **License**
This project is licensed under the [MIT License](LICENSE).
📧 **Contact**
For any questions or feedback, please open an issue on the [GitHub repository](https://github.com/rishipradeep-think41/google-drive-mcp).
---