conorbronsdon/gws-mcp-server

Overview

An MCP server that wraps the Google Workspace CLI (gws) as Model Context Protocol tools, enabling AI agents to interact with Google Workspace services programmatically. Built in TypeScript, it translates MCP tool calls into gws commands for tasks like managing email, calendar, and contacts.

Best for

Best for
Developers building MCP-based AI agents that need basic Google Workspace automation

Use cases

• Automating email search and send operations via AI assistants
• Managing calendar events and contacts through natural language prompts
• Integrating Google Workspace workflows into MCP-compatible agent pipelines

How to use

Install

npm install -g gws-mcp-server

Tools exposed

• drive_files_list
• drive_files_get
• drive_files_create
• drive_files_copy
• drive_files_update
• drive_files_delete
• drive_files_export
• drive_files_download
• drive_permissions_create
• sheets_get
• sheets_values_get
• sheets_values_update
• sheets_values_append
• calendar_events_list
• calendar_events_get
• calendar_events_insert
• calendar_events_update
• calendar_events_delete
• docs_get
• docs_create

Tested with

Claude Code, Claude Desktop

Example client config

[object Object]

Notes

An MCP server that wraps the Google Workspace CLI (gws) as Model Context Protocol tools, enabling AI agents to interact with Google Workspace services programmatically. Built in TypeScript, it translates MCP tool calls into gws commands for tasks like managing email, calendar, and contacts.

4 stars on GitHub. Last updated 2026-04-23. Licensed MIT.

Use cases

• Automating email search and send operations via AI assistants
• Managing calendar events and contacts through natural language prompts
• Integrating Google Workspace workflows into MCP-compatible agent pipelines

Pros

• Leverages existing gws CLI for reliable Google Workspace access
• Simple MCP interface reduces boilerplate for agent integration
• TypeScript codebase is approachable for most developers

Cons

• Requires separate gws CLI installation and authentication setup
• Limited to operations exposed by gws, not full Google API coverage
• Small community and low star count may mean less support

Indexed from awesome-mcp-servers-punkpeye and enriched against its public facts.