Skip to content
MCP server

Google Workspace (gsuite-sdk)

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

Runs locallyStatus and history
Install
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-mcp

Add 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`Required
  • GSUITE_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)

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  5. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  6. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media