Keyflow

Search Keyflow

Find a shortcut, workflow, MCP server or skill

Google Workspace

local MCP server

Google Workspace is a local MCP server: Give AI agents access to Gmail, Calendar, Drive, and more — multi-account, manifest-driven. Install it from npm as @aaronsb/google-workspace-mcp.

Installation

Terminal

claude mcp add io-github-aaronsb-google-workspace -e GOOGLE_CLIENT_ID=... -e GOOGLE_CLIENT_SECRET=... -- npx -y @aaronsb/google-workspace-mcp

Run in your project folder. Add --scope user to use it everywhere.

Claude Desktop, Cursor & other clients

Add to claude_desktop_config.json or .cursor/mcp.json.

{
  "mcpServers": {
    "io-github-aaronsb-google-workspace": {
      "command": "npx",
      "args": [
        "-y",
        "@aaronsb/google-workspace-mcp"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "...",
        "GOOGLE_CLIENT_SECRET": "..."
      }
    }
  }
}

Fill in the environment variables with your own credentials.

What you need

  • Runtime: Node.js 18+ (runs with npx).
  • MCP client: Claude Code, Codex, Antigravity, Claude Desktop, Cursor or any other client that speaks MCP over stdio.
  • Environment variables: GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET

Summary

Give AI agents access to Gmail, Calendar, Drive, and more — multi-account, manifest-driven

Google Workspace vs similar servers

ServerStarsTypeAPI keyRuntime
Google Workspace189LocalYesnpm
Google Drive MCP222LocalYesnpm
x-use168LocalYespypi
Google Workspace MCP Server10LocalNonpm
exa5,056HostedNoNone

Questions

It reads 2 environment variables: GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET. Set them in your MCP config before starting the server.

Node.js 18+ (runs with npx), plus an MCP client such as Claude Code, Codex, Claude Desktop or Cursor.

Google Workspace is a local MCP server distributed as the npm package @aaronsb/google-workspace-mcp.

Run: claude mcp add io-github-aaronsb-google-workspace -e GOOGLE_CLIENT_ID=... -e GOOGLE_CLIENT_SECRET=... -- npx -y @aaronsb/google-workspace-mcp

Run: codex mcp add io-github-aaronsb-google-workspace --env GOOGLE_CLIENT_ID=... --env GOOGLE_CLIENT_SECRET=... -- npx -y @aaronsb/google-workspace-mcp

Similar MCP servers

NameStars
  1. Google Drive MCPio.github.piotr-agier/google-drive-mcp222
  2. x-useio.github.ihuzaifashoukat/x-use168
  3. Google Workspace MCP Serverio.github.conorbronsdon/gws-mcp-server10
  4. exaai.exa/exa5,056
  5. FableCutio.github.ronak-create/fablecut695
  6. Postman MCP Servercom.postman/postman-mcp-server317
  7. mcpio.github.agenticmail/mcp229
  8. ITASCA MCP Serverio.github.yusong652/itasca-mcp196