Google Workspace MCP Server

by mindstoneio.github.mindstone/mcp-server-google-workspacev0.4.2

Google Workspace MCP server for Gmail, Calendar, Drive, Docs, Sheets, Slides, Contacts, and more

12Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active10d ago

Install Google Workspace MCP server

claude mcp add google-workspace-mindstone -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

{
  "mcpServers": {
    "google-workspace-mindstone": {
      "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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "google-workspace-mindstone": {
      "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>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "google-workspace-mindstone": {
      "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>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "google-workspace-mindstone": {
      "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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
GOOGLE_CLIENT_ID	yes	—	Google OAuth client ID
GOOGLE_CLIENT_SECRET	yes	yes	Google OAuth client secret
ACCOUNTS_PATH	yes	—	Path to accounts.json written by the MCP host
CREDENTIALS_PATH	yes	—	Directory containing per-account Google OAuth token files
GOOGLE_WORKSPACE_REQUEST_TIMEOUT_MS	—	—	Outbound Google API request timeout in milliseconds (max 300000 = 5 min)
GOOGLE_WORKSPACE_DISABLE_REFRESH	—	—	Set to 1 to disable background OAuth token refresh (tokens are only read, never refreshed)
MCP_WORKSPACE_PATH	—	—	Directory attachments and downloaded files are constrained to (defaults to a temp dir; reads/writes outside it are refused)
WORKSPACE_BASE_PATH	—	—	Legacy fallback for MCP_WORKSPACE_PATH; prefer MCP_WORKSPACE_PATH
GAUTH_FILE	—	—	Legacy fallback path to gauth.json OAuth client config; host-orchestrated setups use GOOGLE_CLIENT_ID/GOOGLE_CLIENT_SECRET instead

Freshness

Active — last maintenance signal 10d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-09-29 · 10d ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-09-29 · 10d ago · official registry · v0.4.2

FAQ

›How do I install the Google Workspace MCP server in Claude Code?

Run: claude mcp add google-workspace-mindstone -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. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Google Workspace require an API key?

Yes. It expects GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, ACCOUNTS_PATH, CREDENTIALS_PATH, of which 1 is a secret.

›Can I use Google Workspace as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Google Workspace in the official MCP registry?

Yes, as io.github.mindstone/mcp-server-google-workspace.