mcp-server-drive
A Google Drive MCP server. Runs locally as a subprocess of any MCP client (Claude Code, etc.), authenticates the user with their own Google account via OAuth, and exposes three read-only tools.
Tools
| Tool | What it does |
|---|---|
search_files |
Run a Drive query string (name = '…' and mimeType = '…' and trashed = false). Returns id, name, mimeType, parents, modifiedTime. |
read_file_content |
Fetch a file's content. Google Docs auto-export to text/markdown, Sheets to text/csv, Slides to text/plain. Override with mime_type. Non-native files come back via alt=media. |
get_file_metadata |
Full Drive metadata for a file: name, mimeType, parents, modified/created time, size, owners, webViewLink. |
Scope: https://www.googleapis.com/auth/drive.readonly. The server never writes to Drive.
Setup
Register an OAuth client in Google Cloud Console:
- Create a project (or reuse one).
- Enable the Google Drive API.
- APIs & Services → Credentials → Create credentials → OAuth client ID → Application type: Desktop app.
- Click Download JSON.
Save the downloaded file as
~/mcp-server-drive-tokens.jsonon every machine that will run the server. The server reads Google's JSON as-is and accepts the three shapes Google produces:{installed: {...}}(Desktop apps),{web: {...}}(Web apps), or a flat{client_id, client_secret, ...}blob.
The file holds the OAuth client credentials (one per Cloud project, shared across users of that client). It is NOT the per-user refresh token — that's written separately after the consent flow; paths below.
Install
npx -y @move32/mcp-server-drive
Or wire it into a plugin's .mcp.json:
{
"mcpServers": {
"gdrive": {
"command": "npx",
"args": ["-y", "@move32/mcp-server-drive"]
}
}
}
On first tool call, a browser tab opens for Google's consent screen. The user signs in with their personal Google account, grants read access, and the server stores the refresh token. Subsequent calls reuse the token silently. Access-token refresh is automatic.
Development
npm install
npm run lint # ESLint 9 flat config, zero warnings
npm run format:check # Prettier
npm run typecheck # tsc --noEmit
npm test # Vitest unit tests
npm run test:coverage # with v8 coverage
npm run build # emit to dist/
