Google Workspace MCP

🚀 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

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

Setup

Service Account Configuration

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

Environment Variables

The application requires the following environment variables:

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.