Provides comprehensive file management capabilities including file/folder operations (create, upload, move, copy, delete, search), permission and sharing management, commenting and collaboration features, version control, shared drive management, and batch operations for Google Drive.
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-mcpInstall Dependencies:
npm installConfigure 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 |
| List roots (My Drive, Shared with me) |
| List changes in Drive |
| Get metadata of a file |
| List contents of a folder |
| Search files in Google Drive |
| Get storage quota information for the user |
| Get storage usage breakdown by file type |
File Content Operations
Tool Name | Description |
| Retrieve content of a Google Drive file |
| Create file or folder |
| Upload or update file content |
| Append plain text to an existing text file in Drive |
File Management
Tool Name | Description |
| Copy a file or folder to a new location |
| Move a file or folder to a different parent folder |
| Rename a file or folder |
| Trash or delete a file |
| Restore a file from the trash |
| Permanently delete all trashed files |
| Star or unstar a file or folder |
| Lock or unlock a file to prevent changes |
| Create a shortcut to a file or folder |
File Version Management
Tool Name | Description |
| List all versions of a file |
| Delete a specific version of a file |
Permissions & Sharing
Tool Name | Description |
| Manage file permissions |
| List all permissions of a file or folder |
| Update a user's permission on a file or folder |
| Remove a user's access from a file or folder |
| Share file or folder with everyone in a domain |
| Allow anyone with the link to access a file or folder |
Comments & Collaboration
Tool Name | Description |
| Add a comment to a file |
| List all comments on a file |
| Delete a comment from a file |
| Reply to a comment on a file |
| List all replies to a comment |
| Delete a reply to a comment |
Shared Drives (Team Drives)
Tool Name | Description |
| List all accessible Shared Drives |
| Get metadata for a specific Shared Drive |
| Create a new Shared Drive |
| Delete a Shared Drive |
| Update a Shared Drive's metadata |
| List files in a Shared Drive |
Batch Operations
Tool Name | Description |
| Get metadata for multiple files in a single request |
| Update permissions for multiple files at once |
| Delete multiple files or folders at once |
| Copy multiple files to a destination folder |
| 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.
This server cannot be installed