Google Workspace (gsuite-sdk)

io.github.PabloAlanizPublished by GitHub account PabloAlanizv0.13.0Updated Nov 7, 2026

Gmail, Calendar, Drive, Sheets, Tasks and Contacts for agents, with your own Google login

VerifiedSTDIODesktop onlyProductivity & WorkflowCommunication & CollaborationData & Analytics

Overview

AI-generated overview

Local MCP server that lets an assistant work with your own Google Workspace account: Gmail, Calendar, Drive, Sheets, Tasks and Contacts.

What you can do
  • Check login status and available scopes
  • Search, read, send, reply, forward, draft, label and trash Gmail messages
  • List, create and delete Calendar events and check free/busy times
  • Search, read, upload and share Drive files
  • Read, append, update and upsert Google Sheets rows
  • List, add and complete Tasks, and search or manage Contacts and groups
When to use it
Useful when you want an assistant to triage email, schedule meetings, look up or edit spreadsheets and Drive files, or manage tasks and contacts inside your own Google account rather than a shared service account.
Requirements
Runs locally over stdio, launched with uvx from the gsuite-mcp PyPI package. Needs a Google Cloud OAuth client JSON file, a one-time login through the gsuite CLI that writes tokens.db, and the absolute paths in GSUITE_TOKEN_DB_PATH (required) and GSUITE_CREDENTIALS_FILE. GSUITE_DEFAULT_TIMEZONE is optional. Marketing tools need opt-in scopes and their APIs enabled.
Before you install
The server acts with your full Google account permissions: tools can send, forward, share, overwrite and delete mail, files, events, sheet rows and contacts, so confirm before running write actions. tokens.db and the OAuth client file are credentials and should be kept private. A new login replaces stored scopes, so re-list every scope set you rely on. Marketing scopes are read-only but still expose analytics data.

Installation

In SourceWeft

  1. Open Google Workspace (gsuite-sdk) in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

gsuite-mcp

An MCP server for Google Workspace: Gmail, Calendar, Drive, Sheets, Tasks and Contacts, built on gsuite-sdk. It runs locally over stdio and uses your own Google login.

Setup

  1. Get an OAuth client file from Google Cloud (guide) and log in once with the gsuite CLI:

    bash
    pip install "gsuite-sdk[cli]"gsuite auth login                                   # Gmail, Calendar, Drive, Sheetsgsuite auth login --force --scopes default,tasks,contacts   # + Tasks and Contactsgsuite auth login --force --scopes default,tasks,contacts,marketing  # + Search Console, GA4, Tag Manager (read-only)

    The token is saved to tokens.db in the current directory (or GSUITE_TOKEN_DB_PATH).

  2. Add the server to your MCP client, pointing at that token with absolute paths:

    json
    {  "mcpServers": {    "gsuite": {      "command": "uvx",      "args": ["gsuite-mcp"],      "env": {        "GSUITE_TOKEN_DB_PATH": "/Users/you/gsuite/tokens.db",        "GSUITE_CREDENTIALS_FILE": "/Users/you/gsuite/credentials.json",        "GSUITE_DEFAULT_TIMEZONE": "America/Argentina/Buenos_Aires"      }    }  }}

    Claude Code: claude mcp add gsuite -e GSUITE_TOKEN_DB_PATH=/Users/you/gsuite/tokens.db -- uvx gsuite-mcp

Tools

AreaTools
Accountauth_status
Gmailgmail_search, gmail_read, gmail_read_thread, gmail_list_labels, gmail_list_drafts, gmail_send, gmail_reply, gmail_forward, gmail_create_draft, gmail_send_draft, gmail_delete_draft, gmail_modify_labels (archive, read/unread, star, file), gmail_create_label, gmail_trash
Calendarcalendar_list_events, calendar_create_event, calendar_delete_event, calendar_free_busy
Drivedrive_search, drive_read_file, drive_upload, drive_share
Sheetssheets_read, sheets_append, sheets_update, sheets_upsert
Taskstasks_list, tasks_add, tasks_complete
Contactscontacts_search, contacts_get, contacts_list_groups, contacts_group_members, contacts_create_group, contacts_modify_group, contacts_delete_group
Search Console (read-only)searchconsole_list_sites, searchconsole_query, searchconsole_inspect_url, searchconsole_list_sitemaps
Analytics GA4 (read-only)analytics_account_summaries, analytics_list_properties, analytics_run_report, analytics_run_realtime_report
Tag Manager (read-only)tagmanager_list_accounts, tagmanager_list_containers, tagmanager_list_workspaces, tagmanager_list_tags, tagmanager_list_triggers, tagmanager_list_variables, tagmanager_list_versions

Search Console, Analytics and Tag Manager need the opt-in read-only scopes (--scopes ...,marketing) and their APIs enabled in your Cloud project. A login replaces the stored scopes, so keep listing the sets you already use.

Read tools are annotated read-only; tools that send, share, overwrite or delete are marked so clients can ask before running them. Dates are ISO 8601; times without an offset use GSUITE_DEFAULT_TIMEZONE (UTC by default).

The same capabilities are available as an agent skill, a CLI and a REST API: see gsuite-sdk.

License

MIT

Source: packages/mcp/README.md at commit 666ae3c

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

9
  1. v0.13.0LatestNov 7, 2026
  2. v0.10.0Nov 5, 2026
  3. v0.9.0Oct 23, 2026
  4. v0.7.0Oct 22, 2026
  5. v0.6.0Oct 17, 2026
  6. v0.5.2Oct 14, 2026
  7. v0.5.1Oct 14, 2026
  8. v0.5.0Oct 12, 2026
  9. v0.4.0Oct 10, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts