mcp-google-drive
MCP Server for google drive
Installation
Run this command in your terminal to add the MCP server to Claude Code.
Run in terminal:
Command
claude mcp add --transport stdio bantunes82-mcp-google-drive-server /FULL/PATH/TO/target/mcp-google-drive-server \ --env GOOGLE_APPLICATION_CREDENTIALS="/FULL/PATH/TO/application_default_credentials.json"
How to use
This MCP server integrates Google Drive with the MCP workflow, enabling you to upload Microsoft Word files directly to Google Drive via the upload_microsoft_world_file tool. Once configured, you can connect with an MCP client (for example Claude Desktop) and invoke the upload tool to store documents in a specified Google Drive folder or in the root if no folder is provided. The tool returns a URL to the uploaded file in Google Docs view format, making it easy to share or reference the document from within your MCP-enabled conversations.
How to install
Prerequisites:
- Claude Desktop or another MCP client
- Java 24+ and Maven (or use the Native Binary as described)
- Google Cloud project with Drive API enabled and credentials file
Installation steps:
- Clone the repository and navigate to the project:
git clone <this-repo>
cd mcp-google-drive-server
- Build the native binary (STDIO mode) or the jar (Java build):
# Native binary (No Java)
./mvnw clean package -Pnative,mcp-stdio
# Java build (Traditional)
./mvnw clean package
- Obtain Google application credentials as described in the README and place the credentials file locally, e.g. application_default_credentials.json.
- Run or configure the server with the appropriate command and environment, as shown below (configuring via MCP client is described in the Running section):
{
"mcpServers": {
"mcp-google-drive-server": {
"command": "/FULL/PATH/TO/target/mcp-google-drive-server",
"args": [],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "/FULL/PATH/TO/application_default_credentials.json"
}
}
}
}
Additional notes
Tips and common issues:
- Ensure the GOOGLE_APPLICATION_CREDENTIALS file points to a valid service account credential with Drive access.
- Use absolute paths for the binary/jar and credentials in your MCP config.
- If the MCP tool cannot be found in Claude Desktop, verify the binary/jar path and environment variables, then restart Claude Desktop.
- When testing with MCP Inspector, you may need to supply a valid access token obtained from the /oauth2/token endpoint using client credentials.
- For the native binary, the startup time is very fast; for the Java build, the startup will depend on the JVM and jar size.
- The server exposes the upload_microsoft_world_file tool which takes folderName (optional), fileName, and fileContent; the tool returns a Google Drive URL.