Google Drive & Workspace MCP Server for Antigravity

A Model Context Protocol (MCP) server that equips Google Antigravity (agy) and other MCP-compliant agents with comprehensive tools to create, read, update, and search across Google Drive, Google Docs, Google Sheets, Google Slides, and Google Forms.

🛠️ Included Tools

📁 Google Drive

• gdrive_search: Search for files, folders, Docs, Sheets, and Slides using Drive queries (e.g. name contains 'Report' and mimeType = 'application/vnd.google-apps.document').

• gdrive_list: List files and folders with optional parent folder filtering and page sizing.

• gdrive_create_folder: Create new folders/directories in Drive or within specific subfolders.

📝 Google Docs

• gdocs_create: Create a new Google Document with an optional initial text body and destination folder.

• gdocs_read: Extract and read text content, headings, and table data by Document ID.

• gdocs_modify: Append text, insert text at specific character indexes, or perform find-and-replace updates.

📊 Google Sheets

• gsheets_create: Create a new Google Spreadsheet with custom sheet tab names and initial 2D cell row/column data.

• gsheets_read: Read spreadsheet metadata and retrieve cell values using standard A1 notation (e.g. Sheet1!A1:D20).

• gsheets_modify: Update cell values, append rows to tables, clear ranges, add or remove sheet tabs, or execute raw batch updates.

📽️ Google Slides

• gslides_create: Create a new Google Slides presentation with a title and optional destination folder.

• gslides_read: Inspect presentation structure, slides, text frames, shapes, and tables.

• gslides_modify: Create new slides (with custom predefined layouts), replace text across slides, insert text into shapes, create text boxes, or execute raw batch updates.

📋 Google Forms

• gforms_create: Create a new Google Form with title, description, and initial questions. Supports TEXT, PARAGRAPH, RADIO, CHECKBOX, DROP_DOWN, SCALE, DATE, TIME, and SECTION_HEADER.

• gforms_read: Read form structure, questions, items, edit URL, and responder URL by Form ID.

• gforms_modify: Update form metadata, add question items, delete items, or execute raw batch updates.

• gforms_read_responses: Fetch user responses, mapping question IDs to question titles with respondent emails and timestamps.

Related MCP server: mcp-server-drive

🚀 Quick Setup Guide for Antigravity (agy)

1. Prerequisites: Google Cloud OAuth 2.0 Credentials

Each user authenticates with their own Google account:

1. Open the Google Cloud Console.

2. Create a new Google Cloud Project (e.g., Antigravity-Workspace-MCP).

3. Navigate to APIs & Services > Library and enable the following 5 APIs:

   • Google Drive API

   • Google Docs API

   • Google Sheets API

   • Google Slides API

   • Google Forms API

4. Navigate to APIs & Services > OAuth consent screen:

   • Choose External user type and click Create.

   • Fill in required fields (App name: Antigravity Workspace, User support email, Developer email).

   • Under Scopes, click Add or Remove Scopes and add:

     • https://www.googleapis.com/auth/drive

     • https://www.googleapis.com/auth/documents

     • https://www.googleapis.com/auth/spreadsheets

     • https://www.googleapis.com/auth/presentations

     • https://www.googleapis.com/auth/forms.body

     • https://www.googleapis.com/auth/forms.responses.readonly

   • Under Test users, add your Google Account email address (the account that owns the Drive files you want to access).

   • Save and complete the consent screen setup.

5. Navigate to APIs & Services > Credentials:

   • Click + Create Credentials > OAuth client ID.

   • Application type: Desktop app (or Web application with Authorized redirect URI http://localhost:3000/oauth2callback).

   • Click Create, then click Download JSON.

   • Save the downloaded JSON file to ~/.gemini/gdrive-credentials.json on the machine running Antigravity.

2. Installation

Clone this repository to your global Antigravity MCP directory:

mkdir -p ~/.gemini/mcp-servers
git clone https://github.com/yottabit42/google_drive_mcp_antigravity.git ~/.gemini/mcp-servers/gdrive-mcp
cd ~/.gemini/mcp-servers/gdrive-mcp
npm install

3. Authenticate

Run the authorization script:

# Print the OAuth URL (ideal for remote, headless containers, or agent-assisted flow)
node auth.js --url

1. Open the printed authorization URL in your web browser.

2. Sign in with the Google Account added as a test user and click Allow on the consent screen.

3. The browser will redirect to http://localhost:3000/oauth2callback?code=....

4. Copy either the full URL or the code parameter value from your browser address bar.

5. Finish token exchange by running:

   node auth.js "<PASTED_CODE_OR_REDIRECT_URL>"

6. The token is securely saved to ~/.gemini/gdrive-token.json. Refresh tokens are automatically persisted when refreshed.

4. Configure Antigravity (agy)

Add the server to your Antigravity configuration at ~/.gemini/config/mcp_config.json:

{
  "mcpServers": {
    "google-drive": {
      "command": "node",
      "args": [
        "/root/.gemini/mcp-servers/gdrive-mcp/index.js"
      ],
      "env": {
        "GDRIVE_OAUTH_PATH": "/root/.gemini/gdrive-credentials.json",
        "GDRIVE_CREDENTIALS_PATH": "/root/.gemini/gdrive-token.json"
      }
    }
  }
}

(Note: Replace /root with your actual home directory if running as a non-root user, or omit the env block to use the default ~/.gemini/ path).

5. Verify Setup

Run the smoke test to verify API communication:

node smoke_test.js

You should see:

--- Google Drive & Workspace MCP Smoke Test ---
✅ Google Drive API connection successful!
Found 5 recent files.
   - Quarterly Plan (application/vnd.google-apps.document) [ID: ...]

Restart your agy session, and the Google Drive tools will be automatically available to the agent!

🔒 Security & Privacy

• No credentials, client secrets, or OAuth tokens are bundled with this repository.

• Tokens and OAuth credentials are saved locally in the user's ~/.gemini/ directory.

• All tokens are managed directly between the host machine and official Google APIs (googleapis).

📄 License

MIT