Gdrive MCP Server

🚀 Google Drive MCP Server

A powerful Model Context Protocol (MCP) server that provides seamless integration with Google Drive, allowing AI models to search, list, and read files in Google Drive.

🚀 Quick Start

Prerequisites

• Node.js (v14 or higher)
• npm (5.7 or higher)

Installation

npm install gdrive-mcp-server

Usage Examples

Basic Usage

import { GDriveMCP } from 'gdrive-mcp-server';

async function main() {
  const gdrive = new GDriveMCP({
    credentialsPath: './credentials.json',
    tokenPath: './token.json'
  });

  // Search for files
  const files = await gdrive.search({ query: 'quarterly report' });
  console.log('Search results:', files);

  // Read file content
  const contents = await gdrive.read('your-file-id');
  console.log('File content:', contents);
}

main().catch(console.error);

✨ Features

Tools

1. gdrive_search

Search for files in your Google Drive using a powerful full-text search feature.

• Input:

  {
    "query": "string (Your search query)"
  }
  

• Output: A list of files containing the following information:
  • File name
  • MIME type
  • File ID
  • Last modified time
  • File size

2. gdrive_read_file

Read file content directly using the Google Drive file ID.

• Input:

  {
    "file_id": "string (Google Drive file ID)"
  }
  

• Output: File content converted in an appropriate format

Automatic File Format Handling

The server intelligently handles different Google Workspace file types:

• 📝 Google Docs → Markdown
• 📊 Google Sheets → CSV
• 📊 Google Presentations → Text
• 🎨 Google Drawings → PNG
• 📄 Text/JSON files → UTF-8 text
• 📦 Other files → Base64 encoded

📦 Configuration

Create a Credentials File

Add your Google Drive credentials to credentials.json:

{
  "type": "service_account",
  "project_id": "your-project-id",
  "private_key_id": "your-private-key-id",
  "private_key": "your-private-key",
  "client_email": "your-client-email",
  "token_uri": "https://oauth2.googleapis.com/token"
}

Authentication Process

1. Access the Google Cloud Console using your Google account.
2. Create a new project or select an existing one.
3. Enable the Drive API v3 API.
4. Create a service account and download the JSON key file (i.e., credentials.json).

Authorization

Run your application to obtain the necessary OAuth tokens:

node src/auth.js

📄 Security

• All sensitive credentials are stored in the credentials directory.
• OAuth credentials and tokens are not under version control.
• Read-only access to Google Drive.
• Use a secure OAuth 2.0 authentication process.

🤝 Contribution

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This MCP server is distributed under the MIT License. See the LICENSE file for details.

🔍 Troubleshooting

If you encounter issues:

1. Verify your Google Cloud project settings.
2. Ensure that all required OAuth scopes are enabled.
3. Check that the credentials are correctly placed in the credentials directory.
4. Verify file permissions and access rights in Google Drive.

📚 More Resources

• Google Drive API Documentation
• OAuth 2.0 for Desktop Apps
• Model Context Protocol Documentation