mcpserver.so LogoMCPFly
Submit
Google Workspace MCP Server logo

Google Workspace MCP Server

by Yulikepython

Productivitygoogle-workspacemcp-servergmailcalendarautomation

This application provides Google Workspace functionalities (Calendar, Email) as an MCP server. It is based on the epaproditus/google-workspace-mcp-server repository.

View on GitHub

Last updated: N/A

Google Workspace MCP Server

このプロジェクトは以下のリポジトリをベースに作成しています： epaproditus/google-workspace-mcp-server

Google Workspace の機能（カレンダー、メール）を MCP サーバーとして提供するアプリケーション

機能

Gmail 機能

  • list_emails: 受信トレイから最近のメールをフィルタリング付きで一覧表示
  • search_emails: Gmail クエリ構文を使用した高度なメール検索
  • send_email: CC、BCC 対応のメール送信
  • modify_email: メールラベルの管理（アーカイブ、ゴミ箱、既読/未読）

カレンダー機能

  • list_events: 日付範囲指定付きの予定一覧表示
  • create_event: 参加者付きの予定作成
  • update_event: 既存予定の更新
  • delete_event: 予定の削除

必要条件

  1. Node.js: Node.js 20 以上をインストール
  2. Google Cloud Console 設定:
    • Google Cloud Consoleにアクセス
    • 新規プロジェクトの作成または既存プロジェクトの選択
    • Gmail API と Google Calendar API の有効化:
      1. "APIs & Services" > "Library"に移動
      2. "Gmail API"を検索して有効化
      3. "Google Calendar API"を検索して有効化
    • OAuth 2.0 認証情報の設定:
      1. "APIs & Services" > "Credentials"に移動
      2. "Create Credentials" > "OAuth client ID"をクリック
      3. "Desktop application"を選択
      4. "Authorized redirect URIs"にhttp://localhost:4100/codeを追加
      5. Client ID と Client Secret をメモ

セットアップ手順

  1. リポジトリのクローンとインストール:

    git clone https://github.com/Yulikepython/gogole-workspace-mcp-server-by-itc.git
cd google-workspace-mcp-server-by-itc
npm install

  2. 認証情報の設定:

    # credentials.json.exampleをコピー
cp credentials.json.example credentials.json

    credentials.jsonを以下のように編集:

    {
  "web": {
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET",
    "redirect_uris": ["http://localhost:4100/code"],
    "auth_uri": "https://accounts.google.com/o/oauth2/auth",
    "token_uri": "https://oauth2.googleapis.com/token"
  }
}

  3. リフレッシュトークンの取得:

    node get-refresh-token.js

    これにより:

    • ブラウザが開き、Google OAuth 認証が実行されます
    • 以下の権限が要求されます:
      • https://www.googleapis.com/auth/gmail.modify
      • https://www.googleapis.com/auth/calendar
      • https://www.googleapis.com/auth/gmail.send
    • 認証情報がtoken.jsonに保存されます
    • コンソールにリフレッシュトークンが表示されます

  4. MCP 設定の構成: MCP 設定ファイルにサーバー設定を追加:

    • VSCode Claude 拡張機能: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
    • Claude デスクトップアプリ: ~/Library/Application Support/Claude/claude_desktop_config.json

    mcpServersオブジェクトに以下を追加:

    {
  "mcpServers": {
    "google-workspace": {
      "command": "node",
      "args": ["/path/to/google-workspace-server/build/index.js"],
      "env": {
        "GOOGLE_CLIENT_ID": "your_client_id",
        "GOOGLE_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

  5. ビルドと実行:

    npm run build

  6. デプロイ設定の追加 (.env):

    deploy スクリプトを使用するには .env ファイルが必要です。

    cp .env.example .env

    .env に以下の環境変数を設定してください:

    SSH_USER=your_ssh_user
SSH_HOST=your.ssh.host
SSH_PATH=/your/deploy/path

npm scripts

| コマンド | 説明 | |----------------|-------------------------------------| | npm run build| バンドルを作成し、実行可能権限を付与 | | npm run start| ローカルでビルド＆実行 | | npm run clean| ビルド成果物を削除 | | npm run deploy| ビルド後、本番環境にファイルをデプロイ | | npm run logs | 本番環境のアプリケーションログをリアルタイムで表示 |

使用例

Gmail 操作

  1. 最近のメール一覧:

    {
  "maxResults": 5,
  "query": "is:unread"
}

  2. メール検索:

    {
  "query": "from:[email protected] has:attachment",
  "maxResults": 10
}

  3. メール送信:

    {
  "to": "[email protected]",
  "subject": "Hello",
  "body": "Message content",
  "cc": "[email protected]",
  "bcc": "[email protected]"
}

  4. メールラベルの変更:

    {
  "id": "message_id",
  "addLabels": ["UNREAD"],
  "removeLabels": ["INBOX"]
}

カレンダー操作

  1. 予定一覧:

    {
  "maxResults": 10,
  "timeMin": "2024-01-01T00:00:00Z",
  "timeMax": "2024-12-31T23:59:59Z"
}

  2. 予定作成:

    {
  "summary": "Team Meeting",
  "location": "Conference Room",
  "description": "Weekly sync-up",
  "start": "2024-01-24T10:00:00Z",
  "end": "2024-01-24T11:00:00Z",
  "attendees": ["[email protected]"]
}

  3. 予定更新:

    {
  "eventId": "event_id",
  "summary": "Updated Meeting Title",
  "location": "Virtual",
  "start": "2024-01-24T11:00:00Z",
  "end": "2024-01-24T12:00:00Z"
}

  4. 予定削除:

    {
  "eventId": "event_id"
}

トラブルシューティング

  1. 認証の問題:

    • 必要な OAuth スコープが付与されているか確認
    • Client ID と Secret が正しいか確認
    • リフレッシュトークンが有効か確認

  2. API エラー:

    • Google Cloud Console で API クォータと制限を確認
    • プロジェクトで API が有効化されているか確認
    • リクエストパラメータが正しい形式か確認

ライセンス

MIT