# Gws Connector

> Gws Connector is an open-source MCP server for productivity. One MCP server for several Gmail and Google Workspace accounts, routed by label or domain. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux, self-hosted
- **Website:** https://orieg.github.io/gws-connector/
- **Repository:** https://github.com/orieg/gws-connector
- **MCP Registry name:** io.github.orieg/gws-connector
- **Categories:** productivity, communication
- **Listing updated:** 2026-11-17

## About

Most Google MCP servers handle one account per instance. This one holds any number of Gmail and Workspace logins at once and sends each request to the right one by label (such as work), email address or domain. Each account can use its own Google Cloud OAuth credentials, which helps when different organisations keep separate projects.

It ships as a single static Go binary that talks stdio, with a one-click bundle, a Claude Code plugin and a Gemini extension. Client secrets and tokens go into the operating system keychain, with a file fallback on Linux without GNOME Keyring. The tool set spans mail, calendar, Drive, Sheets, Docs, Contacts, Tasks and Slides, plus account management commands.

Tasks and Contacts were added later behind new OAuth scopes, so existing users must re-authorize each account and enable the Tasks API in their Google Cloud project before those tools work.

## Features

- **Multiple accounts:** Connect unlimited Gmail and Workspace accounts in one session.
- **Smart routing:** Target an account by label, email or domain.
- **Per-account OAuth:** Each organisation can bring its own Google Cloud credentials.
- **Keychain storage:** Secrets and tokens kept in the OS keychain.
- **Wide Workspace coverage:** Mail, Calendar, Drive, Sheets, Docs, Contacts, Tasks and Slides.
- **Single Go binary:** No Python or Node runtime to install.

## Good for

- Read personal and work inboxes in one assistant session
- Schedule events across several calendars
- Pull data from spreadsheets owned by different clients
- Draft replies from one account while searching another

## Install

### Claude Code (Terminal)

```sh
claude mcp add gws-connector -- npx -y https://github.com/orieg/gws-connector/releases/download/v0.4.3/gws-mcp.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "gws-connector": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/orieg/gws-connector/releases/download/v0.4.3/gws-mcp.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "gws-connector": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/orieg/gws-connector/releases/download/v0.4.3/gws-mcp.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "gws-connector": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/orieg/gws-connector/releases/download/v0.4.3/gws-mcp.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "gws-connector": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/orieg/gws-connector/releases/download/v0.4.3/gws-mcp.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "gws-connector": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/orieg/gws-connector/releases/download/v0.4.3/gws-mcp.mcpb"
      ]
    }
  }
}
```

## Tools

- `gws.mail.search`: Search messages
- `gws.mail.read_message`: Read a message
- `gws.mail.read_thread`: Read a thread
- `gws.mail.create_draft`: Create a draft
- `gws.mail.forward`: Forward as a draft
- `gws.mail.send_draft`: Send a draft
- `gws.mail.get_attachment`: Download an attachment
- `gws.mail.list_labels`: List labels
- `gws.mail.create_label`: Create a label
- `gws.mail.modify_message`: Modify labels
- `gws.mail.get_profile`: Profile info
- `gws.cal.list_events`: List events
- `gws.cal.get_event`: Event details
- `gws.cal.create_event`: Create an event
- `gws.cal.update_event`: Update or reschedule an event
- `gws.cal.delete_event`: Cancel an event
- `gws.cal.free_busy`: Free/busy query
- `gws.cal.list_calendars`: List calendars
- `gws.drive.search`: Search files
- `gws.drive.read_file`: Read file content
- `gws.drive.list_folder`: List a folder
- `gws.sheets.read_range`: Read an A1 range
- `gws.sheets.write_range`: Write cell values
- `gws.sheets.append`: Append rows after a table
- `gws.sheets.clear`: Clear values in a range
- `gws.sheets.create`: Create a spreadsheet
- `gws.sheets.list_tabs`: List tabs and sheet metadata
- `gws.sheets.duplicate_tab`: Duplicate a tab with formatting
- `gws.sheets.add_tab`: Add an empty tab
- `gws.docs.read`: Read as plain text and tree
- `gws.docs.insert_text`: Insert text at an index or the end
- `gws.docs.replace_text`: Literal find and replace
- `gws.docs.create`: Create a document
- `gws.accounts.list`: List accounts
- `gws.accounts.add`: Connect an account
- `gws.accounts.reauth`: Re-authorize an account
- `gws.accounts.complete`: Finalize a pending OAuth flow
- `gws.accounts.remove`: Disconnect an account
- `gws.accounts.set_default`: Set the default account
- `gws.contacts.search`: Search your contacts
- `gws.contacts.directory_search`: Search the org directory
- `gws.tasks.list_tasklists`: List task lists
- `gws.tasks.list`: List tasks
- `gws.tasks.create`: Create a task
- `gws.tasks.complete`: Complete a task
- `gws.tasks.delete`: Delete a task
- `gws.slides.get`: Read a presentation
- `gws.slides.create`: Create a presentation
- `gws.slides.batch_update`: Apply Slides API edits

## FAQ

### Which clients work with it?

The README lists Claude Code, Gemini CLI, GitHub Copilot, Cursor, OpenAI Codex and any MCP-compatible client.

### How are credentials stored?

In the OS keychain, with a file fallback on Linux without GNOME Keyring.

### Do I need to re-authorize after upgrading?

Yes, for the Tasks and Contacts tools, each connected account must be re-authorized to get the new scopes.

### How many tools are there?

The README counts 49 tools across mail, calendar, Drive, Sheets, Docs, contacts, tasks, slides and accounts.

### Is Gws Connector free?

Yes. Gws Connector is open source, so you can use and self-host it for free.

### How do I add Gws Connector to Claude Code?

Run this command in your terminal: claude mcp add gws-connector -- npx -y https://github.com/orieg/gws-connector/releases/download/v0.4.3/gws-mcp.mcpb

### What are the best alternatives to Gws Connector?

The closest alternatives to Gws Connector are Ha MCP, Concord MCP, note1, BoardAgent and Callout.

## 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.
- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [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.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.

---
Source: https://ai-powered.com/mcp/gws-connector
