ankitpyc/gdrive-mcp-server

Google Drive MCP Server ☁️

This project implements a Model Context Protocol (MCP) server that provides tools and resources for interacting with Google Drive. It allows for programmatic access to Google Drive functionalities, enabling other MCP-compatible agents or systems to manage files and folders.

Table of Contents

• Current Features
• Project Structure
• Setup Instructions
  • Prerequisites
  • Configuration
  • Running the Server
• Usage
• Planned Features
• Contributing
• License

Current Features ✨

The server currently provides the following functionalities:

• File and Folder Listing 📂: List files and folders within a specified Google Drive folder, including the root.
• File Creation 📄: Create new files with specified content in a given Google Drive path.
• DOCX File Creation 📝: Create new .docx files with specified content in a given Google Drive path.
• Folder Suggestion 💡: Suggests a Google Drive folder based on the content name.

Project Structure 🏗️

The project follows a standard Go project layout:

• cmd/server/: Contains the main application entry point for the MCP server.
• configs/: Stores configuration files, such as the Google Service Account credentials.
• internal/: Reserved for private application and library code that should not be imported by other applications.
• pkg/driveapi/: Contains reusable library code for interacting with the Google Drive API. This includes client setup, file operations, folder management, and suggestion logic.

Setup Instructions 🛠️

To set up and run the Google Drive MCP Server, follow these steps:

Prerequisites ✅

• Go (version 1.18 or higher)
• Docker or Podman (for running the MCP server)
• Google Cloud Project with Google Drive API enabled
• Service Account Key (JSON file) for authentication with Google Drive API

Configuration ⚙️

1. Enable Google Drive API:

   • Go to the Google Cloud Console.
   • Create a new project or select an existing one.
   • Navigate to "APIs & Services" > "Library".
   • Search for "Google Drive API" and enable it.

2. Create a Service Account:

   • In the Google Cloud Console, go to "APIs & Services" > "Credentials".
   • Click "Create Credentials" > "Service Account".
   • Follow the steps to create a new service account.
   • Grant the service account appropriate roles (e.g., "Drive File Organizer" or "Drive Editor") to access Google Drive.

3. Generate a Service Account Key:

   • After creating the service account, click on its email address.
   • Go to the "Keys" tab and click "Add Key" > "Create new key".
   • Select "JSON" as the key type and click "Create".
   • A JSON file will be downloaded. Rename it to credentials.json and place it in the configs/ directory of this project.

4. Share Google Drive Folders/Files with Service Account:

   • The service account needs explicit access to the Google Drive folders/files it will interact with. Share the relevant folders/files with the service account's email address (found in the credentials.json file).

Running the Server 🚀

1. Build the Docker Image:

   docker build -t gdrive-mcp-server .
   

   or

   podman build -t gdrive-mcp-server .
   

2. Run the MCP Server:

   docker run --rm -i -e GOOGLE_APPLICATION_CREDENTIALS=/app/configs/credentials.json -v $(pwd)/configs:/app/configs gdrive-mcp-server
   

   or

   podman run --rm -i -e GOOGLE_APPLICATION_CREDENTIALS=/app/configs/credentials.json -v $(pwd)/configs:/app/configs gdrive-mcp-server
   

   Ensure that $(pwd)/configs correctly points to the directory containing your credentials.json file.

Usage 💡

Once the server is running, you can interact with it using an MCP-compatible client. The server exposes various tools for Google Drive operations. Refer to the MCP client documentation for details on how to call these tools.

Planned Features 🔮

• File Update: Update existing files in Google Drive.
• File Deletion: Delete files from Google Drive.
• Folder Creation: Create new folders in Google Drive.
• File Search: Advanced search capabilities for files based on various criteria (name, type, content).
• Permissions Management: Manage file and folder permissions.
• Webhooks/Notifications: Integrate with Google Drive change notifications.

Contributing 🤝

We welcome contributions to the Google Drive MCP Server! If you have suggestions, bug reports, or want to contribute code, please open an issue or submit a pull request on the GitHub repository.

License 📄

This project is licensed under the MIT License - see the file for details.