ORCA Drive SA MCP

A Model Context Protocol (MCP) server that exposes a Google Drive folder over Streamable HTTP, deployed as a Vercel serverless function.

It reads Google Drive through a Google service account (Drive API v3, read-only scope), so no Apps Script web app is needed.

Tools

Tool	Description
`list_files`	List files in a folder (defaults to `DRIVE_FOLDER_ID`)
`search_files`	Search files by name substring
`get_file`	Fetch metadata for a single file by ID
`read_file`	Read text content of a file (JSON, CSV, TXT, etc.)

Go to https://console.cloud.google.com and create (or select) a project.
Enable the Google Drive API (APIs & Services → Library → "Google Drive API").
Create a service account:
- APIs & Services → Credentials → Create credentials → Service account.
- Give it a name and click Create and continue, then Done.
Generate a key:
- Open the service account → Keys → Add key → Create new key → JSON.
- Download the JSON key file.
Copy the service account email (e.g. orca-drive@my-project.iam.gserviceaccount.com).
Share the target Drive folder with that email (right-click the folder in Drive → Share → paste the email → Viewer).

Only files/folders shared with the service account are accessible.

Copy .env.example to .env (local dev) and set the same values in Vercel (Project > Settings > Environment Variables):

Variable	Description
`GOOGLE_SERVICE_ACCOUNT_JSON`	The full JSON key contents (single line)
`GOOGLE_SERVICE_ACCOUNT_JSON_ENCODED`	Set to `base64` if the JSON value is base64-encoded
`DRIVE_FOLDER_ID`	Default folder ID to list

npm install
vercel dev

Test with the MCP Inspector (npx @modelcontextprotocol/inspector) using transport Streamable HTTP and URL http://localhost:3000/.

vercel --prod

Your endpoint will be https://<project>.vercel.app/.

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "orca-drive-sa": {
      "type": "http",
      "url": "https://<project>.vercel.app/"
    }
  }
}