Google Drive MCP Server

A Model Context Protocol (MCP) server for Google Drive integration. This server allows AI assistants to interact directly with your Google Drive, providing tools to read, search, list folders, and upload files.

Built with TypeScript and utilizing the official Google APIs Node.js Client.

---

Available Modules & Tools

Files & Folders

Manage and search your Google Drive contents.

• list_recent_files: Lists recent files from Google Drive, ordered by recency, modification date, or name.
• search_files: Searches for files and folders in Google Drive by name or content. Accepts plain text or Drive query syntax.
• list_folder: Lists the contents (files and subfolders) of a specific Google Drive folder by its ID. Works with both My Drive and Shared Drives.
• read_file_content: Reads the text content of a Google Drive file (Docs, Sheets, PDFs, plain text).
• get_file_metadata: Returns metadata of a Drive file: name, MIME type, size, owners, modification date, parent folders, and view link.
• upload_file: Uploads a file to Google Drive. Pass text content directly or base64-encoded content for binary files.
• upload_file_from_path: Uploads a file from a local path on the server to Google Drive. Useful for processing generated files.

---

Setup & Installation

1. Clone the repository:

   git clone https://github.com/Themetralla3000/google-drive-mcp-server.git
   cd google-drive-mcp-server
   

2. Install dependencies:

   npm install
   

3. Copy the environment template and configure your credentials:

   cp .env.example .env
   

4. Build the project:

   npm run build
   

Configuration

You must provide Google Drive API credentials via the .env file. These can be obtained from the Google Cloud Console by creating an OAuth 2.0 Client ID.

GOOGLE_DRIVE_CLIENT_ID=your-client-id
GOOGLE_DRIVE_CLIENT_SECRET=your-client-secret
GOOGLE_DRIVE_REFRESH_TOKEN=your-refresh-token

Usage with Claude Desktop / Cursor

To use this MCP with Claude Desktop or Cursor, add the following configuration to your MCP config file (e.g., claude_desktop_config.json):

{
  "mcpServers": {
    "google-drive": {
      "command": "node",
      "args": ["/absolute/path/to/google-drive-mcp-server/build/src/index.js"],
      "env": {
        "GOOGLE_DRIVE_CLIENT_ID": "your-client-id",
        "GOOGLE_DRIVE_CLIENT_SECRET": "your-client-secret",
        "GOOGLE_DRIVE_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}

License

MIT License