Google Workspace MCP Server (Aaron Bockelie)
Gmail, Calendar, Drive, and Sheets interaction for your AI agent via OAuth.
Data last scanned today · Reviewed today
Overview
The Google Workspace MCP Server provides a unified interface for interacting with your Google ecosystem, including Gmail, Calendar, Drive, Docs, Sheets, Tasks, and Meet. It leverages Google OAuth 2.0 to grant your AI agent authenticated access, enabling you to search mail, manage calendar events, or create documents through natural language instructions. The server is designed for ease of deployment, offering a cross-platform bundle for Claude Desktop that streamlines configuration. It requires users to generate their own OAuth credentials through the Google Cloud Console, ensuring that you maintain control over the API permissions granted to the server.
Our verdict
With a security score of 55/100, this server is classified as high-risk. The primary security concern is the lack of a read-only mode, as every installation grants full write access to your workspace data. Because this is a community-maintained project rather than an official tool from Google, users should be comfortable managing their own OAuth credentials and assessing the risks associated with providing write-level permissions to an automated assistant.
- Supports standard OAuth authentication for secure access management.
- Small dependency footprint with only three direct packages used.
- Active development with commits within the last three days.
- Comprehensive documentation provided within the repository README.
- Lacks a read-only mode, exposing full write permissions by default.
- Community-maintained software lacking official support from the platform vendor.
- No homepage link established for centralized project information.
Setup
{
"mcpServers": {
"aaronsb-google-workspace-mcp": {
"args": [
"-y",
"@aaronsb/google-workspace-mcp"
],
"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 |
|---|---|---|
| manage_email | Gmail — search, read (plain or sanitized HTML), send, reply / reply-all, forward, triage, trash, labels, threads, attachments | medium |
| manage_calendar | Calendar — list, agenda, get, create, quickAdd (natural language), update, delete, calendars, freebusy | medium |
| manage_drive | Drive — search, get, upload, download, copy, rename / move, delete, export, permissions, comments, view images | medium |
| manage_sheets | Sheets — read / write ranges (row-numbered output), append, clear, manage tabs, copy / duplicate / rename | medium |
| manage_docs | Docs — get, create, append, insert text, find-and-replace | medium |
| manage_tasks | Tasks — list / create / update / complete tasks and task lists | medium |
| manage_meet | Meet — browse past conferences, participants, transcripts, recordings, smart notes | low |
| manage_accounts | Multi-account lifecycle — add accounts, manage credentials and scopes | medium |
| manage_scratchpad | Compose / edit multi-line content (line- or JSON-path-addressed), attach files, send to any target; JSON mode live-syncs to Docs / Sheets | medium |
| manage_workspace | File operations in the workspace sandbox (exchange point for attachments, downloads, exports) | medium |
Compatibility
| Client | Local | Docker | Remote | Read-only |
|---|---|---|---|---|
| Claude Desktop | ||||
| Cursor | ||||
| VS Code | ||||
| Windsurf | ||||
| ChatGPT |
Frequently asked questions
›What prerequisites are required before using this MCP server?
You must obtain Google OAuth credentials by creating an OAuth 2.0 Client ID with the application type set to 'Desktop app' in the Google Cloud Console. You must also enable the specific Google APIs you intend to use, such as Gmail, Calendar, or Drive.
›Are there specific requirements for the Workspace Directory configuration?
The workspace directory is where attachments, downloads, and exports are stored. It is recommended to use a dedicated folder rather than your home directory, Documents, Desktop, or a Google Drive folder.
›How are my Google credentials and tokens handled?
Your OAuth tokens are kept locally on your own machine. The server interacts with Google services as you, and your credentials never leave your machine.
›Can I use this server with multiple Google accounts?
Yes, you can add as many Google accounts as you like, including both personal and work accounts. The server is designed to manage multi-account handling and will route requests to the appropriate account.
›What are the system requirements to run the server?
If you are running the server via npm or Node, you must use Node version 22.12 or newer. Using the `.mcpb` bundle with Claude Desktop avoids the need to install Node or manage paths manually.
Badge
Maintain this server? Add the live badge to your README.