drio
Open app

Google Workspace MCP Server

Source

A Model Context Protocol server for Google Workspace integration (Gmail and Calendar)

Catalog onlyCatalog onlySTDIO

Overview

The Google Workspace MCP Server is a Model Context Protocol server designed for integrating with Google Workspace APIs, specifically Gmail and Calendar. It allows developers to manage emails and calendar events programmatically using the MCP interface.

To use the Google Workspace MCP Server, you need to clone the repository, set up OAuth credentials, and run the server. Make sure to enable the necessary APIs in the Google Cloud Console before configuring your local environment.

  • Gmail Tools: List, search, send, and modify emails with customizable parameters. - Calendar Tools: List, create, update, and delete calendar events easily. - OAuth 2.0 Authentication: Secure access to Gmail and Calendar APIs with user consent.
  1. Automating email management including filtering and sending bulk emails.
  2. Creating and managing calendar events programmatically for team scheduling.
  3. Developing applications that require integration with Gmail and Calendar APIs.

Add to your AI client

Use these steps to connect Google Workspace MCP 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": {
    "google-workspace-mcp-server-epaproditus": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-google-workspace-mcp-server-epaproditus"
      ]
    }
  }
}

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": {
    "google-workspace-mcp-server-epaproditus": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-google-workspace-mcp-server-epaproditus"
      ]
    }
  }
}

Claude Code

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

.mcp.json (project root)

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

VS Code (Copilot)

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

.vscode/mcp.json

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

Windsurf

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

~/.codeium/windsurf/mcp_config.json

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

Cline

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

Cline MCP Settings (via UI)

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

FAQ

**What are the prerequisites for using this server?**

You need Node.js version 14 or higher and a Google Cloud Project with Gmail and Calendar APIs enabled.

**Is the project open source?**

Yes! The Google Workspace MCP Server is available on GitHub under the MIT License.

**Can I customize the email search queries?**

Yes! The server supports advanced Gmail query syntax for flexible email searching.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":488,"uuid":"c364cd6a-e7eb-441c-9d9e-b8a321043a94","name":"google-workspace-mcp-server","title":"Google Workspace MCP Server","description":"A Model Context Protocol server for Google Workspace integration (Gmail and Calendar)","avatar_url":"https://avatars.githubusercontent.com/u/72703910?v=4","created_at":"2024-12-30T02:51:28.290Z","updated_at":"2025-01-05T02:54:32.868Z","status":"created","author_name":"epaproditus","author_avatar_url":"https://avatars.githubusercontent.com/u/72703910?v=4","tags":"google-workspace,mcp,gmail,calendar,integration","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/epaproditus/google-workspace-mcp-server","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":null,"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"}]]}]

Developer tools