google-workspace-mcp MCP Server

A Model Context Protocol (MCP) server for Google Workspace that provides tools for managing Google Workspace resources through the Admin SDK, Gmail, Calendar, and Drive APIs.

Local serverstdio

What is the google-workspace-mcp Server?

google-workspace-mcp is an MCP project maintained in the orvice/google-workspace-mcp repository. The maintainer describes its purpose as “A Model Context Protocol (MCP) server for Google Workspace that provides tools for managing Google Workspace resources through the Admin SDK, Gmail, Calendar, and Drive…”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using /go/bin/google-workspace-mcp. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares GOOGLE_SERVICE_ACCOUNT, GOOGLE_ADMIN_EMAIL. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
directory_usersList all users in your Google Workspace directory
create_userCreate a new user in Google Workspace
get_userGet detailed information about a specific user
update_userUpdate an existing user's name, password, or organizational unit
delete_userDelete a user from Google Workspace
suspend_userSuspend or restore a user account
list_groupsList groups in a domain
get_groupGet detailed information about a specific group
create_groupCreate a new group in Google Workspace
delete_groupDelete a group from Google Workspace
list_group_membersList members of a group
add_group_memberAdd a member to a group
remove_group_memberRemove a member from a group
list_gmailList recent Gmail messages (requires Gmail API access)
list_calendar_eventsList upcoming calendar events for a user (requires Calendar API access)
create_calendar_eventCreate a new calendar event (requires Calendar API access)
list_drive_filesList files in Google Drive (requires Drive API access)
search_drive_filesSearch for files in Google Drive (requires Drive API access)
get_drive_fileGet detailed information about a specific Drive file (requires Drive API access)
create_drive_folderCreate a new folder in Google Drive (requires Drive API access)
upload_drive_fileUpload a file to Google Drive (requires Drive API access)
share_drive_fileShare a Drive file with another user (requires Drive API access)
list_spreadsheetsList Google Sheets spreadsheets in Drive (requires Sheets API access)
get_spreadsheetGet detailed information about a spreadsheet including its sheets (requires Sheets API access)
read_sheet_rangeRead data from a specific range in a spreadsheet (requires Sheets API access)
write_sheet_rangeWrite data to a specific range in a spreadsheet (requires Sheets API access)
append_sheet_rowsAppend rows of data to a spreadsheet (requires Sheets API access)
create_spreadsheetCreate a new Google Sheets spreadsheet (requires Sheets API access)
list_task_listsList all Google Tasks task lists for a user (requires Tasks API access)
list_tasksList all tasks in a specific task list (requires Tasks API access)
create_taskCreate a new task in a task list (requires Tasks API access)
update_taskUpdate an existing task (requires Tasks API access)
delete_taskDelete a task from a task list (requires Tasks API access)
complete_taskMark a task as completed (requires Tasks API access)

How to install the google-workspace-mcp Server

{
  "mcpServers": {
    "googleworkspace-mcp": {
      "command": "/go/bin/google-workspace-mcp",
      "args": [],
      "env": {
        "GOOGLE_SERVICE_ACCOUNT": "test.json",
        "GOOGLE_ADMIN_EMAIL": "admin@yourdomain.com"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
GOOGLE_SERVICE_ACCOUNTDeclared in the maintainer’s client configuration.Check documentation
GOOGLE_ADMIN_EMAILDeclared in the maintainer’s client configuration.Check documentation