Google Workspace MCP Server By Itc

🚀 谷歌工作区 MCP サーバ

このサーバは、Google Workspaceのメールとカレンダーに関する操作を提供します。メールの検索や送信、カレンダーの日程の作成や更新などの機能を持っています。

🚀 クイックスタート

このサーバを使用する前に、以下の必要条件を満たしてください。

1. Node.js と npm をインストールします。
2. Google Workspace の開発者認証情報を設定します。
3. Gmail API と Calendar API を有効にします。

✨ 主な機能

メール操作

• 最近のメールリスト

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

• メール検索

  {
    "query": "from:example@gmail.com has:attachment",
    "maxResults": 10
  }
  

• メール送信

  {
    "to": "recipient@example.com",
    "subject": "Hello",
    "body": "Message content",
    "cc": "cc@example.com",
    "bcc": "bcc@example.com"
  }
  

• メールラベルの変更

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

カレンダー操作

• 日程の確認

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

• 日程の作成

  {
    "summary": "团队会议",
    "location": "会议室",
    "description": "每周同步",
    "start": "2024-01-24T10:00:00Z",
    "end": "2024-01-24T11:00:00Z",
    "attendees": ["colleague@example.com"]
  }
  

• 日程の更新

  {
    "eventId": "event_id",
    "summary": "更新后的会议标题",
    "location": "虚拟会议室",
    "start": "2024-01-24T11:00:00Z",
    "end": "2024-01-24T12:00:00Z"
  }
  

• 日程の削除

  {
    "eventId": "event_id"
  }
  

📦 インストール

プロジェクトの初期化

npm init -y

依存関係のインストール

npm install express cors @google/googleapis

設定ファイルの作成

config.js を作成します。

const config = {
    google: {
        clientId: 'YOUR_CLIENT_ID',
        clientSecret: 'YOUR_CLIENT_SECRET',
        refreshToken: 'YOUR_REFRESH_TOKEN'
    }
};

module.exports = config;

API 呼び出しの実装

コード例を参考にしてください。

const {google} = require('googleapis');
const config = require('./config');

function gmailApiCall() {
    const auth = new google.auth.OAuth2(config.google.clientId, 
                                       config.google.clientSecret,
                                       config.google.refreshToken);
    // 具体的な API 呼び出しロジックを実装
}

function calendarApiCall() {
    const auth = new google.auth.OAuth2(config.google.clientId,
                                       config.google.clientSecret,
                                       config.google.refreshToken);
    // 具体的なカレンダー API 呼び出しロジックを実装
}

プロジェクトのビルド

npm run build

💻 使用例

基本的な使用法

サーバを起動するには、以下のコマンドを実行します。

npm start

📚 ドキュメント

よくある問題のトラブルシューティング

• サーバを起動できない場合
  ポートが使用中か、設定ファイルに誤りがないかを確認してください。

• API リクエストが失敗する場合
  認証情報が有効で、ネットワーク接続が正常であることを確認してください。

• ログ情報が不十分な場合
  詳細なログ記録を有効にして、より多くのデバッグ情報を取得してください。

参考ドキュメント

• Node.js 公式ドキュメント
• Google APIs ノードライブラリ
• Gmail API ドキュメント
• Calendar API ドキュメント