drio
Open app

MCP Google Workspace Server

Source

MCP Server for Gmail and Calendar

Catalog onlyCatalog onlySTDIO

Overview

MCP Google Workspace Server is a Model Context Protocol server designed to facilitate interaction with Google Workspace services, specifically Gmail and Google Calendar.

To use the server, clone the repository from GitHub, install the necessary dependencies, configure OAuth 2.0 credentials, and start the server to listen for MCP commands.

  • Multiple Google Account Support: Switch between multiple Google accounts with custom metadata. - Gmail Integration: Advanced email querying, reading, managing drafts, replying, and bulk operations. - Calendar Integration: List calendars, view events, create and delete events with timezone support.
  1. Managing multiple Gmail accounts efficiently.
  2. Automating email responses and drafts.
  3. Scheduling and managing calendar events seamlessly.

Add to your AI client

Use these steps to connect MCP Google Workspace Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

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

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

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

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

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

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "mcp-google-workspace-j3k0": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-google-workspace-j3k0"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

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

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

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

FAQ

Can I use multiple Google accounts?

Yes! The server supports multiple Google accounts with custom metadata.

Is there a specific Node.js version required?

Yes, Node.js version 18 or higher is required.

How do I set up OAuth 2.0?

Follow the instructions in the documentation to create OAuth2 credentials in the Google Cloud Console.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":1875,"uuid":"71af0c5e-0493-4e8e-b8a6-41dd35f6e402","name":"mcp-google-workspace","title":"MCP Google Workspace Server","description":"MCP Server for Gmail and Calendar","avatar_url":"https://avatars.githubusercontent.com/u/191881?v=4","created_at":"2025-03-05T05:50:26.537Z","updated_at":"2025-03-12T10:21:15.073Z","status":"created","author_name":"j3k0","author_avatar_url":"https://avatars.githubusercontent.com/u/191881?v=4","tags":"[]","category":"cloud-platforms","is_featured":false,"sort":1,"url":"https://github.com/j3k0/mcp-google-workspace","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"5\",\"license\":\"MIT license\",\"language\":\"TypeScript\",\"is_official\":false,\"latest_commit_time\":\"2025-04-01 13:44:07\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Cloud platforms