Google Workspace MCP Server for Claude Desktop

A TypeScript MCP (Model Context Protocol) server that gives Claude Desktop read/write access to Google Docs, Sheets, Drive, and Calendar.

24 tools across four services — create, edit, search, and manage your Google Workspace files and events directly from Claude.

Features

Google Docs

• docs_get — Read full document content
• docs_create — Create a new document
• docs_append — Append text to a document
• docs_replace — Find and replace text
• docs_delete — Move a document to trash

Google Sheets

• sheets_get — Read cell values from a range
• sheets_create — Create a new spreadsheet
• sheets_update — Write values to a range
• sheets_append — Append rows to a sheet
• sheets_clear — Clear a range
• sheets_delete — Move a spreadsheet to trash

Google Drive

• drive_list — List files and folders
• drive_search — Search files by name
• drive_get — Get file metadata
• drive_create_folder — Create a folder
• drive_move — Move a file to a different folder
• drive_delete — Move a file to trash

Google Calendar

• calendar_list — List all calendars
• calendar_events — List upcoming events
• calendar_search — Search events by text
• calendar_get — Get full event details
• calendar_create — Create a new event
• calendar_update — Update an existing event
• calendar_delete — Delete an event

Prerequisites

• Node.js 18 or higher
• A Google Cloud project with OAuth 2.0 credentials

Setup

1. Google Cloud Console

1. Go to console.cloud.google.com
2. Create a new project (or select an existing one)
3. Navigate to APIs & Services → Credentials
4. Click Create Credentials → OAuth Client ID
5. Choose Desktop Application as the application type
6. Download or note the Client ID and Client Secret

Enable the following APIs for your project:

• Google Docs API
• Google Drive API
• Google Sheets API
• Google Calendar API

2. Install and Build

git clone https://github.com/laltaffer/google-workspace-mcp.git
cd google-workspace-mcp
npm install
npm run build

3. Configure Claude Desktop

Add the following to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "google-workspace": {
      "command": "node",
      "args": ["/absolute/path/to/google-workspace-mcp/dist/index.js"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Replace /absolute/path/to/google-workspace-mcp with the actual path where you cloned the repo.

4. Restart Claude Desktop

Fully quit and reopen Claude Desktop.

5. Authorize

In a new Claude chat, say:

"Call the authorize tool"

Claude will return a Google authorization URL. Open it in your browser, sign in, and grant access. Your browser will show "Authorization complete!" — you only need to do this once. Tokens are saved to ~/.google-workspace-mcp/tokens.json.

You can now use all Google Workspace tools in Claude.

Upgrading? If you previously authorized without Calendar support, delete ~/.google-workspace-mcp/tokens.json and re-authorize to grant calendar permissions.

Usage Examples

"List my Google Drive files"

"Create a new Google Doc called 'Meeting Notes' and add an agenda"

"Read the spreadsheet with ID 1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms and summarize it"

"Find all documents with 'Q1' in the name"

"Append a new row to my budget spreadsheet: ['March', '4500', 'Rent']"

"What's on my calendar this week?"

"Create a meeting called 'Design Review' tomorrow at 2pm for 1 hour"

Development

npm test          # run tests
npm run test:watch  # watch mode
npm run build     # compile TypeScript

The project uses vitest for testing with mocked googleapis clients. 29 tests across auth, Drive, Docs, Sheets, and Calendar modules.

Token Storage

OAuth tokens are stored locally at ~/.google-workspace-mcp/tokens.json. They are never committed to this repository. To revoke access, delete that file or revoke the app in your Google Account security settings.

Tech Stack

• TypeScript
• @modelcontextprotocol/sdk
• googleapis
• zod
• vitest