English | 日本語

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

• 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

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/

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

Add to ~/.claude.json:

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

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

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

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

This server supports two access modes:

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

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

{
  "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"
      }
    }
  }
}

{
  "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"
      }
    }
  }
}

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

Apache License 2.0

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.json に追加:

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

~/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つのアクセスモードをサポートしています:

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

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

{
  "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"
      }
    }
  }
}

{
  "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"
      }
    }
  }
}

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

• AI アシスタントが行うアクションを確認する
• 信頼できないコンテンツ（不明な送信元からのメール、ドキュメントなど）を処理しない
• 認証情報はシステムキーチェーンに安全に保存されます

Apache License 2.0