What is Google Drive Mcp

Google Drive MCP Server is a stateless server that integrates Google Drive functionalities with the Model Context Protocol (MCP), providing tools for file management, content retrieval, and permission handling through a standardized interface.

Use cases

Use cases include automating file management tasks, building applications that require Google Drive integration, managing permissions for shared files, and tracking changes in collaborative environments.

How to use

To use google-drive-mcp, clone the repository from GitHub, navigate to the project directory, and install the required dependencies using npm. After setup, you can utilize various commands to interact with Google Drive.

Key features

Key features include root listing of Drive locations, folder browsing, file metadata retrieval, file exporting, uploading, text appending, file deletion, permission management, commenting, change tracking, and file searching.

Where to use

Google Drive MCP can be used in various fields such as software development, data management, and collaborative projects where integration with Google Drive is needed.

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:

   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:

   npm install
   

3. Configure Environment Variables:
   Create a .env file 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=8081
   

   Ensure you have a valid Google OAuth2 client and refresh token with appropriate Drive API scopes.

4. Start the Server:

   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

File Content Operations

File Management

File Version Management

Permissions & Sharing

Comments & Collaboration

Shared Drives (Team Drives)

Batch Operations

🔐 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.