mcpField
G
Google Workspace (gsuite-sdk)

Google Workspace (gsuite-sdk)

Local
pabloalaniz.github.ioProductivity0Updated today
RepositoryVisit website

About Google Workspace (gsuite-sdk)

Google Workspace (gsuite-sdk) is a locally run MCP server for agents using a user's Google login. It exposes tools for Gmail, Calendar, Drive, Sheets, Tasks, Contacts, and optional read-only marketing services.

Key features

  1. 01Search, read, send, and draft Gmail
  2. 02List and manage Calendar events
  3. 03Search, read, upload, and share Drive files
  4. 04Read and update Sheets
  5. 05Manage Tasks and search Contacts
  6. 06Read Search Console, GA4, and Tag Manager

Use cases

  1. 01Search and respond to Gmail messages
  2. 02Create Calendar events and check availability
  3. 03Update Sheets and organize Drive files
  4. 04Query read-only website analytics

MCP support

Runs locally over stdio and exposes Google Workspace tools to MCP clients. Authentication uses the user's Google login, with scope selection for Tasks, Contacts, Search Console, Analytics, and Tag Manager.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "pabloalaniz-gsuite-sdk": {
      "command": "uvx",
      "args": [
        "gsuite-mcp"
      ],
      "env": {
        "GSUITE_TOKEN_DB_PATH": "<GSUITE_TOKEN_DB_PATH>",
        "GSUITE_CREDENTIALS_FILE": "<GSUITE_CREDENTIALS_FILE>",
        "GSUITE_DEFAULT_TIMEZONE": "<GSUITE_DEFAULT_TIMEZONE>"
      }
    }
  }
}
Run commanduvx gsuite-mcp
Environment variables to set
GSUITE_TOKEN_DB_PATHSecretAbsolute path to the tokens.db written by `gsuite auth login`
GSUITE_CREDENTIALS_FILESecretAbsolute 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

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypigsuite-mcp0.9.0

Tools

23

Saved tool list · updated 5d ago

This tool takes no parameters.

Details

From the project 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:

    pip install "gsuite-sdk[cli]"
gsuite auth login                                   # Gmail, Calendar, Drive, Sheets
gsuite auth login --force --scopes default,tasks,contacts   # + Tasks and Contacts
gsuite 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:

    {
  "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_send, gmail_reply, gmail_create_draft
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
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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.