Skip to content
MCP server

Gws Connector

One MCP server for several Gmail and Google Workspace accounts, routed by label or domain

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.4.3
Listing updated
today

About Gws Connector

Gws Connector is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "gws-connector": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/orieg/gws-connector/releases/download/v0.4.3/gws-mcp.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "gws-connector": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/orieg/gws-connector/releases/download/v0.4.3/gws-mcp.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (49)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Open source

Prices change. Check orieg.github.io before you buy.

Gws Connector 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 to Gws Connector

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  5. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  6. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media