Google Workspace MCP Server

Name: Google Workspace MCP Server
Author: Yulikepython

@Yulikepython

Repository

About Google Workspace MCP Server

No overview available yet

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "google-workspace-mcp-server-by-itc": {
      "command": "node",
      "args": [
        "get-refresh-token.js"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Google Workspace MCP Server?

Google Workspace MCP Server provides Gmail and Google Calendar functionality through the Model Context Protocol (MCP). It is for developers and users who want to control email and calendar operations programmatically via MCP-compatible clients like Claude.

How to use Google Workspace MCP Server?

Clone the repository, run npm install, configure OAuth credentials in credentials.json, and obtain a refresh token by executing node get-refresh-token.js. Then add a server entry to your MCP settings file with the environment variables GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, and GOOGLE_REFRESH_TOKEN. Finally, run npm run build and npm run start.

Key features of Google Workspace MCP Server

List recent emails with filtering support
Search emails using Gmail query syntax
Send emails with CC and BCC support
Modify email labels (archive, trash, read/unread)
List calendar events with date range
Create, update, and delete calendar events

Use cases of Google Workspace MCP Server

Automate email triage by searching and labeling messages
Schedule meetings with attendees directly from an MCP client
Send emails programmatically with CC and BCC
Review and manage calendar events within a specified date range

FAQ from Google Workspace MCP Server

What OAuth scopes does the server require?

The server requests https://www.googleapis.com/auth/gmail.modify, https://www.googleapis.com/auth/gmail.send, and https://www.googleapis.com/auth/calendar.

What runtime is required?

Node.js 20 or higher.

How do I get the required credentials?

Enable the Gmail API and Google Calendar API in Google Cloud Console, create an OAuth 2.0 client ID for a desktop application, and set http://localhost:4100/code as an authorized redirect URI.

Where do I configure the MCP server settings?

For Claude Desktop, edit ~/Library/Application Support/Claude/claude_desktop_config.json. For VS Code Claude extension, edit ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json.

How can I troubleshoot authentication issues?

Verify that the required OAuth scopes were granted, check that the Client ID and Client Secret are correct, and ensure the refresh token is still valid.