# Google Workspace (gsuite-sdk)

> Google Workspace (gsuite-sdk) is an open-source MCP server for productivity. Gmail, Calendar, Drive, Sheets, Tasks and Contacts for agents, using your own Google login. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Website:** https://pabloalaniz.github.io/google-suite/
- **Repository:** https://github.com/pabloalaniz/google-suite/tree/HEAD/packages/mcp
- **MCP Registry name:** io.github.PabloAlaniz/gsuite-sdk
- **Categories:** productivity
- **Listing updated:** 2026-11-14

## About

Gsuite-mcp is the MCP front end to the gsuite-sdk Python library, and it runs locally over stdio with credentials you create yourself. You make an OAuth client in Google Cloud, log in once with the gsuite CLI, and point the server at the saved tokens.db file, so no third-party service holds your Google access.

The tool set is large, spanning mail (search, read, send, reply, forward, drafts, labels, trash), calendar events and free/busy, Drive search, upload and sharing, and spreadsheet read, append, update and upsert. Tasks and Contacts are opt-in scopes, and Search Console, Analytics 4 and Tag Manager are available read-only behind a separate marketing scope. Read tools are annotated read-only, while tools that send, share, overwrite or delete are marked so clients can prompt first.

Times without an offset use GSUITE_DEFAULT_TIMEZONE, which defaults to UTC. A fresh login replaces stored scopes, so you must list every scope set you still want. The same code also ships as an agent skill, CLI and REST API. License is MIT.

## Features

- **Own Google login:** Uses your OAuth client and a local token database.
- **Mail management:** Search, read, send, reply, forward, draft, label and trash messages.
- **Calendar and Drive:** Create events, check free/busy, search and share files.
- **Sheets editing:** Read, append, update and upsert spreadsheet rows.
- **Opt-in scopes:** Tasks, Contacts and marketing analytics scopes are enabled only when requested.
- **Read-only marketing data:** Search Console, GA4 and Tag Manager tools cannot modify anything.
- **Action annotations:** Tools that send, share or delete are flagged for client confirmation.

## Good for

- Find and summarise unread mail from a specific sender
- Draft and send a reply from an assistant after review
- Check free/busy before proposing meeting times
- Append rows to a Sheets log
- Pull a GA4 report or Search Console query for a site

## Install

### Claude Code (Terminal)

```sh
claude mcp add gsuite-sdk --env GSUITE_TOKEN_DB_PATH='<GSUITE_TOKEN_DB_PATH>' -- uvx gsuite-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "gsuite-sdk": {
      "command": "uvx",
      "args": [
        "gsuite-mcp"
      ],
      "env": {
        "GSUITE_TOKEN_DB_PATH": "<GSUITE_TOKEN_DB_PATH>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "gsuite-sdk": {
      "command": "uvx",
      "args": [
        "gsuite-mcp"
      ],
      "env": {
        "GSUITE_TOKEN_DB_PATH": "<GSUITE_TOKEN_DB_PATH>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "gsuite-sdk": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "gsuite-mcp"
      ],
      "env": {
        "GSUITE_TOKEN_DB_PATH": "<GSUITE_TOKEN_DB_PATH>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "gsuite-sdk": {
      "command": "uvx",
      "args": [
        "gsuite-mcp"
      ],
      "env": {
        "GSUITE_TOKEN_DB_PATH": "<GSUITE_TOKEN_DB_PATH>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "gsuite-sdk": {
      "command": "uvx",
      "args": [
        "gsuite-mcp"
      ],
      "env": {
        "GSUITE_TOKEN_DB_PATH": "<GSUITE_TOKEN_DB_PATH>"
      }
    }
  }
}
```

## Tools

- `auth_status`: Google tool: Status.
- `gmail_search`: Gmail tool: Search.
- `gmail_read`: Gmail tool: Read.
- `gmail_read_thread`: Gmail tool: Read thread.
- `gmail_list_labels`: Gmail tool: List labels.
- `gmail_list_drafts`: Gmail tool: List drafts.
- `gmail_send`: Gmail tool: Send.
- `gmail_reply`: Gmail tool: Reply.
- `gmail_forward`: Gmail tool: Forward.
- `gmail_create_draft`: Gmail tool: Create draft.
- `gmail_send_draft`: Gmail tool: Send draft.
- `gmail_delete_draft`: Gmail tool: Delete draft.
- `gmail_modify_labels`: Gmail tool: Modify labels.
- `gmail_create_label`: Gmail tool: Create label.
- `gmail_trash`: Gmail tool: Trash.
- `calendar_list_events`: Google Calendar tool: List events.
- `calendar_create_event`: Google Calendar tool: Create event.
- `calendar_delete_event`: Google Calendar tool: Delete event.
- `calendar_free_busy`: Google Calendar tool: Free busy.
- `drive_search`: Google Drive tool: Search.
- `drive_read_file`: Google Drive tool: Read file.
- `drive_upload`: Google Drive tool: Upload.
- `drive_share`: Google Drive tool: Share.
- `sheets_read`: Google Sheets tool: Read.
- `sheets_append`: Google Sheets tool: Append.
- `sheets_update`: Google Sheets tool: Update.
- `sheets_upsert`: Google Sheets tool: Upsert.
- `tasks_list`: Google Tasks tool: List.
- `tasks_add`: Google Tasks tool: Add.
- `tasks_complete`: Google Tasks tool: Complete.
- `contacts_search`: Google Contacts tool: Search.
- `contacts_get`: Google Contacts tool: Get.
- `contacts_list_groups`: Google Contacts tool: List groups.
- `contacts_group_members`: Google Contacts tool: Group members.
- `contacts_create_group`: Google Contacts tool: Create group.
- `contacts_modify_group`: Google Contacts tool: Modify group.
- `contacts_delete_group`: Google Contacts tool: Delete group.
- `searchconsole_list_sites`: Search Console tool: List sites.
- `searchconsole_query`: Search Console tool: Query.
- `searchconsole_inspect_url`: Search Console tool: Inspect url.
- `searchconsole_list_sitemaps`: Search Console tool: List sitemaps.
- `analytics_account_summaries`: Google Analytics 4 tool: Account summaries.
- `analytics_list_properties`: Google Analytics 4 tool: List properties.
- `analytics_run_report`: Google Analytics 4 tool: Run report.
- `analytics_run_realtime_report`: Google Analytics 4 tool: Run realtime report.
- `tagmanager_list_accounts`: Tag Manager tool: List accounts.
- `tagmanager_list_containers`: Tag Manager tool: List containers.
- `tagmanager_list_workspaces`: Tag Manager tool: List workspaces.
- `tagmanager_list_tags`: Tag Manager tool: List tags.
- `tagmanager_list_triggers`: Tag Manager tool: List triggers.
- `tagmanager_list_variables`: Tag Manager tool: List variables.
- `tagmanager_list_versions`: Tag Manager tool: List versions.

## FAQ

### How does it authenticate?

With your own Google OAuth client file and a one-time gsuite auth login, stored in tokens.db.

### Which environment variables are needed?

GSUITE_TOKEN_DB_PATH is required; GSUITE_CREDENTIALS_FILE and GSUITE_DEFAULT_TIMEZONE are optional.

### Can it modify Search Console or Analytics?

No, those tools are read-only.

### What licence is it under?

MIT.

### Why did my Tasks access disappear after re-login?

A login replaces stored scopes, so list every scope set you want each time.

### Is Google Workspace (gsuite-sdk) free?

Yes. Google Workspace (gsuite-sdk) is open source, so you can use and self-host it for free.

### How do I add Google Workspace (gsuite-sdk) to Claude Code?

Run this command in your terminal: claude mcp add gsuite-sdk --env GSUITE_TOKEN_DB_PATH='<GSUITE_TOKEN_DB_PATH>' -- uvx gsuite-mcp

### What are the best alternatives to Google Workspace (gsuite-sdk)?

The closest alternatives to Google Workspace (gsuite-sdk) are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/google-workspace-gsuite-sdk
