Google Drive server
About
> **Notice** > This MCP server is adapted from [modelcontextprotocol/servers (src/gdrive)](https://github.com/modelcontextprotocol/servers/tree/main/src/gdrive), with updates and modifications applied for customization. > 이 MCP 서버는 [modelcontextprotocol/servers…
Details
- Author
- ejoyee
- Downloads
- 241
- Categories
- Other
Jump to
- Search for files in Google Drive by query.
- Access files via URI scheme gdrive:///<file_id>.
- Automatic export of Google Docs to Markdown.
- Automatic export of Google Sheets to CSV.
- Automatic export of Presentations to plain text.
- Automatic export of Drawings to PNG.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Google Drive serverCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Set up a Google Cloud project, enable the Drive API, configure OAuth consent, create an OAuth client ID for a desktop app, and place the key file as gcp-oauth.keys.json in the project root. Build with npm run build or npm run watch. Authenticate by running node ./dist auth and completing the browser flow. Then configure the server in your MCP client—supports NPX (@modelcontextprotocol/server-gdrive) or Docker (mcp/gdrive).
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"google drive server": {
"ej-mcp-server-gdrive": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"--mount",
"type=bind,source=/path/to/gcp-oauth.keys.json,target=/gcp-oauth.keys.json",
"-v",
"mcp-gdrive:/gdrive-server",
"-e",
"GDRIVE_OAUTH_PATH=/gcp-oauth.keys.json",
"-e",
"GDRIVE_CREDENTIALS_PATH=/gdrive-server/credentials.json",
"-p",
"3000:3000",
"mcp/gdrive",
"auth"
]
}
}
}
}McpServers
{
"ej-mcp-server-gdrive": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"--mount",
"type=bind,source=/path/to/gcp-oauth.keys.json,target=/gcp-oauth.keys.json",
"-v",
"mcp-gdrive:/gdrive-server",
"-e",
"GDRIVE_OAUTH_PATH=/gcp-oauth.keys.json",
"-e",
"GDRIVE_CREDENTIALS_PATH=/gdrive-server/credentials.json",
"-p",
"3000:3000",
"mcp/gdrive",
"auth"
]
}
}Google Drive server
This MCP server integrates with Google Drive to allow listing, reading, and searching over files.
Components
Tools
- search
- Search for files in Google Drive
- Input: query (string): Search query
- Returns file names and MIME types of matching files
Resources
The server provides access to Google Drive files:
- Files (gdrive:///<file_id>)
- Supports all file types
- Google Workspace files are automatically exported:
- Docs → Markdown
- Sheets → CSV
- Presentations → Plain text
- Drawings → PNG
- Other files are provided in their native format
Getting started
1. Create a new Google Cloud project
2. Enable the Google Drive API
3. Configure an OAuth consent screen ("internal" is fine for testing)
4. Add OAuth scope https://www.googleapis.com/auth/drive.readonly
5. Create an OAuth Client ID for application type "Desktop App"
6. Download the JSON file of your client's OAuth keys
7. Rename the key file to gcp-oauth.keys.json and place into the root of this repo (i.e. servers/gcp-oauth.keys.json)
Make sure to build the server with either npm run build or npm run watch.
Authentication
To authenticate and save credentials:
1. Run the server with the auth argument: node ./dist auth
2. This will open an authentication flow in your system browser
3. Complete the authentication process
4. Credentials will be saved in the root of this repo (i.e. servers/.gdrive-server-credentials.json)
Usage with Desktop App
To integrate this server with the desktop app, add the following to your app's server configuration:
Docker
Authentication:
Assuming you have completed setting up the OAuth application on Google Cloud, you can now auth the server with the following command, replacing /path/to/gcp-oauth.keys.json with the path to your OAuth keys file:
docker run -i --rm --mount type=bind,source=/path/to/gcp-oauth.keys.json,target=/gcp-oauth.keys.json -v mcp-gdrive:/gdrive-server -e GDRIVE_OAUTH_PATH=/gcp-oauth.keys.json -e "GDRIVE_CREDENTIALS_PATH=/gdrive-server/credentials.json" -p 3000:3000 mcp/gdrive auth
The command will print the URL to open in your browser. Open this URL in your browser and complete the authentication process. The credentials will be saved in the mcp-gdrive volume.
Once authenticated, you can use the server in your app's server configuration:
{
"mcpServers": {
"gdrive": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-v",
"mcp-gdrive:/gdrive-server",
"-e",
"GDRIVE_CREDENTIALS_PATH=/gdrive-server/credentials.json",
"mcp/gdrive"
]
}
}
}
NPX
{
"mcpServers": {
"gdrive": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-gdrive"]
}
}
}
Usage with VS Code
For quick installation, use one of the one-click install buttons below..
For manual installation, add the following JSON block to your User Settings (JSON) file in VS Code. You can do this by pressing Ctrl + Shift + P and typing Preferences: Open User Settings (JSON).
Optionally, you can add it to a file called .vscode/mcp.json in your workspace. This will allow you to share the configuration with others.
> Note that the mcp key is not needed in the .vscode/mcp.json file.
NPX
{
"mcp": {
"servers": {
"gdrive": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-gdrive"],
"env": {
"GDRIVE_CREDENTIALS_PATH": "/path/to/.gdrive-server-credentials.json"
}
}
}
}
}
Docker
{
"mcp": {
"servers": {
"gdrive": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-v",
"mcp-gdrive:/gdrive-server",
"-e",
"GDRIVE_CREDENTIALS_PATH=/gdrive-server/credentials.json",
"mcp/gdrive"
]
}
}
}
}
License
This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
