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_deleteanddrive_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
-
Clone the Repository:
git clone [https://github.com/rishipradeep-think41/google-drive-mcp.git](https://github.com/rishipradeep-think41/google-drive-mcp.git) cd google-drive-mcp -
Install Dependencies:
npm install -
Configure Environment Variables: Create a
.envfile in the root directory and add the following:CLIENT_ID=your_google_client_id CLIENT_SECRET=your_google_client_secret REFRESH_TOKEN=your_google_refresh_token PORT=8081Ensure you have a valid Google OAuth2 client and refresh token with appropriate Drive API scopes.
-
Start the Server:
node index.jsThe 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.
📧 Contact
For any questions or feedback, please open an issue on the GitHub repository.