Google Workspace (gsuite-sdk)
Gmail, Calendar, Drive, Sheets, Tasks and Contacts for agents, using your own Google login
- Pricing
- Open source
- Platforms
- CLI, API
- Runs
- Locally
- Version
- 0.14.0
- Listing updated
- 3 days ago
About Google Workspace (gsuite-sdk)
Google Workspace (gsuite-sdk) is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a terminal
claude mcp add gsuite-sdk --env GSUITE_TOKEN_DB_PATH='<GSUITE_TOKEN_DB_PATH>' -- uvx gsuite-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"gsuite-sdk": {
"command": "uvx",
"args": [
"gsuite-mcp"
],
"env": {
"GSUITE_TOKEN_DB_PATH": "<GSUITE_TOKEN_DB_PATH>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"gsuite-sdk": {
"command": "uvx",
"args": [
"gsuite-mcp"
],
"env": {
"GSUITE_TOKEN_DB_PATH": "<GSUITE_TOKEN_DB_PATH>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"gsuite-sdk": {
"type": "stdio",
"command": "uvx",
"args": [
"gsuite-mcp"
],
"env": {
"GSUITE_TOKEN_DB_PATH": "<GSUITE_TOKEN_DB_PATH>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"gsuite-sdk": {
"command": "uvx",
"args": [
"gsuite-mcp"
],
"env": {
"GSUITE_TOKEN_DB_PATH": "<GSUITE_TOKEN_DB_PATH>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"gsuite-sdk": {
"command": "uvx",
"args": [
"gsuite-mcp"
],
"env": {
"GSUITE_TOKEN_DB_PATH": "<GSUITE_TOKEN_DB_PATH>"
}
}
}
}Configuration
GSUITE_TOKEN_DB_PATHAbsolute path to the tokens.db written by `gsuite auth login`RequiredGSUITE_CREDENTIALS_FILEAbsolute path to the Google OAuth client JSON (needed to refresh the login)GSUITE_DEFAULT_TIMEZONETime zone for dates without an offset, e.g. America/Argentina/Buenos_Aires
Tools this server provides (52)
Taken from the project documentation; the running server may differ.
- 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.
What it does
- 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
Pricing
Open source
MIT licence
Prices change. Check pabloalaniz.github.io before you buy.
Google Workspace (gsuite-sdk) 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 to Google Workspace (gsuite-sdk)

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

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

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

ConvertAudioToText
MCP serverTranscribe audio and video links from Claude or ChatGPT and read the results
Not checked yet- 5 tools
- Remote
- Freemium
- Design and media