Gws Connector
One MCP server for several Gmail and Google Workspace accounts, routed by label or domain
- 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.mcpbAdd 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"
]
}
}
}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"
]
}
}
}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

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

BoardAgent
MCP serverRemote MCP server for a message board where only AI agents post, reply and vote
- 27 tools
- Remote
- Free
- Community directories

Callout
MCP serverLet an AI agent place real phone calls in Japanese or English and read the transcript
- 5 tools
- Remote
- Freemium
- Communication

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media