How do I install the gsuite mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`, `GOOGLE_OAUTH_CREDENTIALS`, `GOOGLE_REDIRECT_URI` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Gsuite MCP Server

Comprehensive Google Workspace MCP server with Gmail, Drive, Calendar, and Contacts integration

Local serverstdio

What is the Gsuite MCP Server?

Comprehensive Google Workspace MCP server with Gmail, Drive, Calendar, and Contacts integration

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

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.

Tool	What it does
google-gmail_list_messages	List messages in user's mailbox with optional filtering
google-gmail_get_message	Get a specific message by ID
google-gmail_send_message	Send an email message. Requires message in RFC 2822 format encoded as base64url string
google-gmail_create_draft	Create a new draft message. IMPORTANT: Message must be an object with 'raw' field containing base64url-encoded RFC 2822 formatted message.
google-gmail_delete_message	PERMANENTLY delete a message - IMMEDIATE and IRREVERSIBLE. WARNING: Use trash_message instead for normal email deletion. Only use this for sensitive data that must be immediately destroyed. Bypasses trash completely. REQ
google-gmail_modify_message	Modify labels on a message (add/remove labels, mark read/unread)
google-gmail_search_messages	search_messages endpoint for google-gmail
google-drive_list_files	List files in Google Drive with optional search query and filtering
google-drive_get_file	Get file metadata by ID
google-drive_update_file	Update file metadata
google-drive_delete_file	Permanently delete a file. Returns 204 No Content with empty body on success.
google-drive_search_files	Advanced file search with complex query syntax
google-drive_create_file	create_file endpoint for google-drive
google-drive_share_file	share_file endpoint for google-drive

How to install the Gsuite MCP Server

{
  "mcpServers": {
    "gsuite": {
      "command": "npx",
      "args": ["@west10tech/gsuite-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "your_google_client_id_here",
        "GOOGLE_CLIENT_SECRET": "your_google_client_secret_here",
        "GOOGLE_OAUTH_CREDENTIALS": "your_google_oauth_credentials_here",
        "GOOGLE_REDIRECT_URI": "your_google_redirect_uri_here"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

Variable	Description	Required
GOOGLE_CLIENT_ID	Configuration value read at startup.	Optional
GOOGLE_CLIENT_SECRET	Credential the server authenticates with.	Yes
GOOGLE_OAUTH_CREDENTIALS	Configuration value read at startup.	Optional
GOOGLE_REDIRECT_URI	Filesystem location the server is allowed to use.	Optional

Example prompts to try

“Use Gsuite to google-gmail list messages.”
“Use Gsuite to google-gmail get message.”
“Use Gsuite to google-gmail send message.”

Frequently asked questions

Comprehensive Google Workspace MCP server with Gmail, Drive, Calendar, and Contacts integration Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.