Google Workspace MCP Server

Gmail and Google Calendar management through integrated AI-driven tool commands.

Data last scanned yesterday · Reviewed last month

0 1 dangerous tool8 tools★ 31JavaScriptMIT

Overview

This server provides an interface to interact with Gmail and Google Calendar APIs directly from your AI assistant. It includes tools for listing, searching, sending, and modifying emails, as well as managing calendar events like creation, updates, and deletion.

Our verdict

This server receives a high-risk score of 18/100, primarily due to it being community-maintained and inactive for 576 days. Because critical components like OAuth support and read-only mode have not been editorially reviewed, users should exercise extreme caution. It is currently unsuitable for use in environments where stability or security audits are required.

Supports granular Gmail and Calendar management actions
Contains only three direct software dependencies
Includes documented setup for OAuth 2.0 credentials

High security risk due to lack of recent maintenance
Not an official Google-maintained project
OAuth and read-only modes remain unverified

Setup

Claude Desktop

{
  "mcpServers": {
    "google-workspace-mcp-server": {
      "args": [
        "-y",
        "google-workspace-server"
      ],
      "command": "npx"
    }
  }
}

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Some servers require API keys or tokens as environment variables — check the project's README and add an "env" object if needed.

No read-only mode — running this grants full read/write access.
No built-in authentication — anyone with access to this config can invoke every tool it exposes.

Tools

Tool	Description	Risk
list_emails	List recent emails from your inbox with optional filtering	low
search_emails	Advanced email search with Gmail query syntax	low
send_email	Send new emails with support for CC and BCC	medium
modify_email	Modify email labels (archive, trash, mark read/unread)	medium
list_events	List upcoming calendar events with date range filtering	low
create_event	Create new calendar events with attendees	medium
update_event	Update existing calendar events	medium
delete_event	Delete calendar events	high

Compatibility

Client	Local	Docker	Remote	Read-only
ChatGPT
Claude Desktop
Cursor
VS Code
Windsurf

Frequently asked questions

›What are the software prerequisites for this server?

You must have Node.js version 14 or higher installed on your machine.

›Do I need to enable specific APIs in Google Cloud?

Yes, you must enable both the Gmail API and the Google Calendar API within your Google Cloud project.

›What permissions are required by this server?

The server requests OAuth scopes for modifying Gmail labels, sending emails, and full access to Google Calendar.

›How do I generate the necessary credentials?

You need to create a credentials.json file and then run the included get-refresh-token.js script to authorize the application and generate a refresh token.

›Where do I configure the server settings?

You add the server configuration to your MCP settings file, such as the Claude desktop config file or the settings file for the VSCode Claude extension.

›How can I troubleshoot authentication issues?

Verify that your client ID and secret are correct, ensure all required OAuth scopes are granted, and confirm your refresh token is valid.