Google Workspace MCP

Google Workspace management tool that provides management functions for resources such as users, emails, and calendars through the Admin SDK

Cloud platform Developer tools #Google management #User management #Email and calendar .Go

rating : 2 points

downloads : 19

update time : 2025-04-29

What is Google Workspace MCP?

The Google Workspace Model Context Protocol (MCP) server provides a simplified way to manage your organization's Google Workspace resources. It acts as a bridge between your applications and Google's Admin SDK, allowing you to perform administrative tasks like user management, email monitoring, and calendar operations without deep technical knowledge.

How to use Google Workspace MCP?

After completing the initial setup with a Google service account, you can use simple commands to manage users, access email data, or handle calendar events. The server handles all the complex API interactions with Google's services.

Use Cases

Ideal for IT administrators needing to automate user management, HR teams onboarding/offboarding employees, or organizations requiring centralized access to email and calendar data across their Google Workspace domain.

Key Features

User Directory ManagementView, create, and manage all users in your Google Workspace directory

Email MonitoringAccess and monitor organizational email accounts (read-only)

Calendar OperationsView and create calendar events for any user in your organization

Pros and Cons

Advantages

Simplifies complex Google Admin SDK operations

Centralized access to multiple Google Workspace services

Reduces need for custom development to integrate with Google APIs

Standardized interface for common administrative tasks

Limitations

Requires initial technical setup with Google service accounts

Limited to functionality available through Google's APIs

Requires Google Workspace admin privileges for full functionality

Some operations may have rate limits imposed by Google

Getting Started

Set Up Google Cloud Project

Create a project in Google Cloud Console and enable the Admin SDK API

Configure Service Account

Create a service account with domain-wide delegation and download the JSON key file

Configure Environment

Set the required environment variables including the path to your service account file

Build and Run

Build the server and start using the available tools

Practical Examples

New Employee OnboardingAutomatically create a new user account when a new employee joins the company

Email Compliance CheckMonitor recent emails for compliance purposes

Frequently Asked Questions

What permissions does the service account need?

Can I use this with a personal Google account?

Is the email access real-time?

Additional Resources

Google Admin SDK Documentation

Official documentation for Google's Admin SDK

Domain-wide Delegation Guide

How to set up domain-wide delegation for service accounts

Sample Configuration Files

Example configuration files for different use cases

🚀 Google Workspace MCP

Google Workspace MCP is a Model Context Protocol (MCP) server for managing Google Workspace resources, providing tools through the Admin SDK.

🚀 Quick Start

Prerequisites

A Google Cloud Platform project with the Admin SDK API enabled.
A service account with appropriate permissions.
The email address of a Google Workspace administrator user for impersonation.

Setup

Service Account Configuration

Create a service account in the Google Cloud Console.
Grant the service account appropriate permissions to use the Google Workspace Admin SDK.
Create and download the JSON key file for the service account.
Enable domain-wide delegation for the service account.
Grant the necessary OAuth scopes to the service account in the Google Workspace Admin Console.

Environment Variables

The application requires the following environment variables:

Property	Details
`GOOGLE_SERVICE_ACCOUNT`	The path to the service account JSON key file.
`GOOGLE_ADMIN_EMAIL`	The email address of the Google Workspace administrator user.

Usage

Build

make build

Configuration Example

{
  "mcpServers": {
     "googleworkspace-mcp": {
      "command": "/go/bin/google-workspace-mcp",
      "args": [],
      "env": {
        "GOOGLE_SERVICE_ACCOUNT": "test.json",
        "GOOGLE_ADMIN_EMAIL": "admin@yourdomain.com"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

⚠️ Important Note

Ensure that your service account has the necessary API access enabled in the Google Cloud Console (Admin SDK API, Gmail API, and Calendar API).

Available Tools

directory_users - List all users in the Google Workspace directory.
create_user - Create a new Google Workspace user.
list_gmail - List recent Gmail messages (requires Gmail API access).
list_calendar_events - List upcoming calendar events for a user (requires Calendar API access).
create_calendar_event - Create a new calendar event (requires Calendar API access).

Required OAuth Scopes

When setting up domain-wide delegation for the service account, grant the following OAuth scopes:

https://www.googleapis.com/auth/admin.directory.user - For accessing and managing directory user information.
https://www.googleapis.com/auth/gmail.readonly - For reading Gmail messages.
https://www.googleapis.com/auth/calendar - For reading and writing calendar events.