Google Workspace · mindstone — Claude Code MCP server: install and setup
Connects AI agents to Gmail, Drive, Docs, and Calendar. Gives coding assistants access to emails, files, and scheduling via 124 tools.
claude mcp add --env GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> --env GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> --env ACCOUNTS_PATH=<ACCOUNTS_PATH> --env CREDENTIALS_PATH=<CREDENTIALS_PATH> --env GOOGLE_WORKSPACE_REQUEST_TIMEOUT_MS=<GOOGLE_WORKSPACE_REQUEST_TIMEOUT_MS> --transport stdio google-workspace -- npx -y @mindstone/mcp-server-google-workspaceWhat Google Workspace does
This connector equips AI agents with 124 tools spanning Gmail, Drive, Calendar, Docs, Sheets, Slides, Tasks, and Meet. It lets models search email threads, send messages, inspect calendar openings, or manipulate files directly in Google storage.
Authentication differs from typical standalone servers. The connector runs no local OAuth callback server and creates no sign-in links on its own. Instead, the host environment carries out the OAuth process and drops credential files into a dedicated path alongside an accounts.json index. When tokens are missing, calls stop and emit an auth_required status.
Running this tool requires Node.js 20 or newer along with valid GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET values. You can also configure request timeouts via GOOGLE_WORKSPACE_REQUEST_TIMEOUT_MS.
What it helps with
- search email threads in Gmail and draft replies
- inspect calendar availability and schedule appointments
- search, retrieve, and organize files in Google Drive
- create and edit content inside Google Docs
Example prompts for the agent
- Find the email from Sarah about yesterday's sprint planning and reply that I am reviewing it.
- List my open calendar slots for tomorrow afternoon.
- Look up the quarterly slide deck on Google Drive and summarize the recent edits.
How to install Google Workspace
Platform CLI
claude mcp add --env GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> --env GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> --env ACCOUNTS_PATH=<ACCOUNTS_PATH> --env CREDENTIALS_PATH=<CREDENTIALS_PATH> --env GOOGLE_WORKSPACE_REQUEST_TIMEOUT_MS=<GOOGLE_WORKSPACE_REQUEST_TIMEOUT_MS> --transport stdio google-workspace -- npx -y @mindstone/mcp-server-google-workspaceReplace <…> with your own values. 4 more environment variables are in the server README
Platform CLI
codex mcp add google-workspace --env GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> --env GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> --env ACCOUNTS_PATH=<ACCOUNTS_PATH> --env CREDENTIALS_PATH=<CREDENTIALS_PATH> --env GOOGLE_WORKSPACE_REQUEST_TIMEOUT_MS=<GOOGLE_WORKSPACE_REQUEST_TIMEOUT_MS> -- npx -y @mindstone/mcp-server-google-workspaceReplace <…> with your own values. 4 more environment variables are in the server README
Config file
{
"mcpServers": {
"google-workspace": {
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-google-workspace"
],
"env": {
"GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
"ACCOUNTS_PATH": "<ACCOUNTS_PATH>",
"CREDENTIALS_PATH": "<CREDENTIALS_PATH>",
"GOOGLE_WORKSPACE_REQUEST_TIMEOUT_MS": "<GOOGLE_WORKSPACE_REQUEST_TIMEOUT_MS>"
}
}
}
}Replace <…> with your own values. 4 more environment variables are in the server README
Config file
{
"servers": {
"google-workspace": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-google-workspace"
],
"env": {
"GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
"ACCOUNTS_PATH": "<ACCOUNTS_PATH>",
"CREDENTIALS_PATH": "<CREDENTIALS_PATH>",
"GOOGLE_WORKSPACE_REQUEST_TIMEOUT_MS": "<GOOGLE_WORKSPACE_REQUEST_TIMEOUT_MS>"
}
}
}
}Replace <…> with your own values. 4 more environment variables are in the server README
Platform CLI
gemini mcp add -e GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> -e GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> -e ACCOUNTS_PATH=<ACCOUNTS_PATH> -e CREDENTIALS_PATH=<CREDENTIALS_PATH> -e GOOGLE_WORKSPACE_REQUEST_TIMEOUT_MS=<GOOGLE_WORKSPACE_REQUEST_TIMEOUT_MS> google-workspace npx -y @mindstone/mcp-server-google-workspaceReplace <…> with your own values. 4 more environment variables are in the server README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Google Workspace
How do I install Google Workspace in Claude Code?
Run `claude mcp add mcp-server-google-workspace -e GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> -e GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> -e ACCOUNTS_PATH=<ACCOUNTS_PATH> -e CREDENTIALS_PATH=<CREDENTIALS_PATH> -- npx -y @mindstone/mcp-server-google-workspace. This registers the server via npx` with your OAuth paths.
What does the Google Workspace MCP server do?
It provides 124 tools for interacting with Google cloud apps, covering Gmail, Drive, Docs, Calendar, Sheets, and Contacts.
How does authentication work?
The server leaves OAuth browser callbacks to the host client. The host saves tokens into the directory set by CREDENTIALS_PATH and updates accounts.json, which the connector reads on demand.
Similar MCP servers
All MCP servers for Notes, tasks and projects →Google Workspace by other authors comes first.
