Google Workspace MCP

English | 日本語

A Model Context Protocol (MCP) server that connects AI assistants to Google Workspace APIs.

English

Features

• Google Calendar - Create, update, delete events, find free time

• Gmail - Search, read, send emails, manage labels

• Google Drive - Search files, create folders, download files

• Google Docs - Create, read, edit documents with Markdown support

• Google Sheets - Read spreadsheet data in multiple formats

• Google Slides - Read presentation content

• Google Chat - Send messages, manage spaces

• People API - Get user profiles and relations

Installation

Download Binary

Download the latest binary from Releases:

# Example: macOS Apple Silicon
curl -L -o workspace-server https://github.com/tomohiro-owada/google-workspace-mcp/releases/latest/download/workspace-server-darwin-arm64
chmod +x workspace-server
sudo mv workspace-server /usr/local/bin/

Build from Source

git clone https://github.com/tomohiro-owada/google-workspace-mcp.git
cd google-workspace-mcp
go build -o workspace-server ./cmd/workspace-server/

Configuration

Claude Code

Add to ~/.claude.json:

{
  "mcpServers": {
    "google-workspace": {
      "command": "/usr/local/bin/workspace-server"
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "google-workspace": {
      "command": "/usr/local/bin/workspace-server"
    }
  }
}

Authentication

This server uses OAuth 2.0 for Google authentication. On first use, you need to authenticate:

# Check auth status
auth.status

# Login (opens browser)
auth.login

# Clear credentials
auth.clear

Access Modes

This server supports two access modes:

Basic Mode (Default)

Works out of the box with read-only permissions. No additional setup required.

Full Access Mode

To enable write operations (send emails, create documents, etc.), you need to set up your own OAuth credentials.

1. Create a Google Cloud Project

1. Go to Google Cloud Console

2. Create a new project (e.g., workspace-mcp)

3. Enable the following APIs:

   • Google Calendar API

   • Gmail API

   • Google Drive API

   • Google Docs API

   • Google Sheets API

   • Google Slides API

   • Google Chat API

   • People API

2. Configure OAuth Consent Screen

1. Go to APIs & Services > OAuth consent screen

2. Choose User Type:

   • Internal: For Google Workspace organizations (all members can use)

   • External: For personal Gmail accounts (requires adding test users or Google verification)

3. Fill in the required fields (App name, User support email, Developer contact)

4. Add scopes (or skip - they'll be requested at runtime)

5. If External: Add test users (your Gmail address)

3. Create OAuth Credentials

1. Go to APIs & Services > Credentials

2. Click Create Credentials > OAuth client ID

3. Select Desktop app

4. Download or copy the Client ID and Client Secret

4. Configure the MCP Server

Add environment variables to your MCP configuration:

Claude Code (~/.claude.json):

{
  "mcpServers": {
    "google-workspace": {
      "command": "/usr/local/bin/workspace-server",
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "google-workspace": {
      "command": "/usr/local/bin/workspace-server",
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

5. Re-authenticate

After configuration, restart the MCP server and run auth.login again.

Available Tools

Security

This server grants AI assistants access to read, modify, and delete your Google Workspace data. Use with caution:

• Review actions taken by AI assistants

• Don't process untrusted content (emails, documents from unknown sources)

• Credentials are stored securely using system keychain

License

Apache License 2.0

Related MCP server: Google Workspace MCP Server

日本語

概要

Google Workspace MCP は、AIアシスタント（Claude Code、Claude Desktop など）を Google Workspace API に接続する Model Context Protocol (MCP) サーバーです。

機能

• Google カレンダー - イベントの作成・更新・削除、空き時間の検索

• Gmail - メールの検索・閲覧・送信、ラベル管理

• Google ドライブ - ファイル検索、フォルダ作成、ファイルダウンロード

• Google ドキュメント - ドキュメントの作成・閲覧・編集（Markdown対応）

• Google スプレッドシート - データの読み取り（テキスト/CSV/JSON形式）

• Google スライド - プレゼンテーション内容の読み取り

• Google Chat - メッセージ送信、スペース管理

• People API - ユーザープロフィール・組織情報の取得

インストール

バイナリをダウンロード

Releases から最新のバイナリをダウンロード:

# 例: macOS Apple Silicon
curl -L -o workspace-server https://github.com/tomohiro-owada/google-workspace-mcp/releases/latest/download/workspace-server-darwin-arm64
chmod +x workspace-server
sudo mv workspace-server /usr/local/bin/

ソースからビルド

git clone https://github.com/tomohiro-owada/google-workspace-mcp.git
cd google-workspace-mcp
go build -o workspace-server ./cmd/workspace-server/

設定

Claude Code

~/.claude.json に追加:

{
  "mcpServers": {
    "google-workspace": {
      "command": "/usr/local/bin/workspace-server"
    }
  }
}

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) に追加:

{
  "mcpServers": {
    "google-workspace": {
      "command": "/usr/local/bin/workspace-server"
    }
  }
}

認証

OAuth 2.0 を使用して Google 認証を行います。初回使用時は認証が必要です:

# 認証状態を確認
auth.status

# ログイン（ブラウザが開きます）
auth.login

# 認証情報をクリア
auth.clear

アクセスモード

このサーバーは2つのアクセスモードをサポートしています:

Basic モード（デフォルト）

追加設定なしで読み取り専用の権限で動作します。

Full Access モード

書き込み操作（メール送信、ドキュメント作成など）を有効にするには、独自のOAuth認証情報を設定する必要があります。

1. Google Cloud プロジェクトを作成

1. Google Cloud Console にアクセス

2. 新しいプロジェクトを作成（例: workspace-mcp）

3. 以下のAPIを有効化:

   • Google Calendar API

   • Gmail API

   • Google Drive API

   • Google Docs API

   • Google Sheets API

   • Google Slides API

   • Google Chat API

   • People API

2. OAuth 同意画面を設定

1. APIとサービス > OAuth 同意画面 に移動

2. ユーザータイプを選択:

   • 内部: Google Workspace 組織向け（組織内の全メンバーが利用可能）

   • 外部: 個人の Gmail アカウント向け（テストユーザーの追加またはGoogle審査が必要）

3. 必須項目を入力（アプリ名、ユーザーサポートメール、デベロッパー連絡先）

4. スコープを追加（またはスキップ - 実行時に要求されます）

5. 外部の場合: テストユーザーを追加（あなたのGmailアドレス）

3. OAuth 認証情報を作成

1. APIとサービス > 認証情報 に移動

2. 認証情報を作成 > OAuth クライアント ID をクリック

3. デスクトップアプリ を選択

4. クライアントID と クライアントシークレット をコピー

4. MCP サーバーを設定

MCP設定に環境変数を追加:

Claude Code (~/.claude.json):

{
  "mcpServers": {
    "google-workspace": {
      "command": "/usr/local/bin/workspace-server",
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "google-workspace": {
      "command": "/usr/local/bin/workspace-server",
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id.apps.googleusercontent.com",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

5. 再認証

設定後、MCPサーバーを再起動し、auth.login を再実行してください。

セキュリティ

このサーバーは AI アシスタントに Google Workspace データの読み取り・変更・削除の権限を付与します。以下の点に注意してください:

• AI アシスタントが行うアクションを確認する

• 信頼できないコンテンツ（不明な送信元からのメール、ドキュメントなど）を処理しない

• 認証情報はシステムキーチェーンに安全に保存されます

ライセンス

Apache License 2.0