Gmail MCP Server 7im

🚀 Gmail MCP サーバー

このサーバーは、Gmail API とのインタラクションツールを提供する Model Context Protocol (MCP) サーバーです。MCP インターフェースを通じて、電子メールのプログラム管理を行うことができます。

✨ 主な機能

Gmail ツール

• list_emails: 受信トレイ内の最近のメールを一覧表示し、オプションでフィルタリングできます。
• search_emails: Gmail のクエリ構文を使用した高度なメール検索が可能です。
• send_email: 新しいメールを送信し、CC と BCC もサポートします。
• modify_email: メールのラベルを変更（アーカイブ、ゴミ箱へ移動、既読/未読のマーク）できます。

📦 インストール

前提条件

1. Node.js: Node.js バージョン 14 以上をインストールしてください。
2. Google Cloud Console の設定:
   • Google Cloud Console にアクセスします。
   • 新しいプロジェクトを作成するか、既存のプロジェクトを選択します。
   • Gmail API を有効にします:
     1. "APIs & Services" > "Library" に移動します。
     2. "Gmail API" を検索して有効にします。
   • OAuth 2.0 の認証情報を設定します:
     1. "APIs & Services" > "Credentials" に移動します。
     2. "Create Credentials" > "OAuth client ID" をクリックします。
     3. "Web アプリケーション" を選択します。
     4. "Authorized redirect URIs" に http://localhost:3001/code を含めるように設定します。
     5. Client ID と Client Secret をメモしておきます。

インストール手順

1. クローンとインストール:

   git clone https://github.com/yourusername/google-gmail-mcp-server.git
   cd google-gmail-mcp-server
   npm install
   

2. OAuth 認証情報の作成: ルートディレクトリに credentials.json ファイルを作成します：

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

3. Refresh Token の取得:

   node get-refresh-token.js
   

   これにより：

   • Google OAuth 認証のためにブラウザが開きます。
   • 以下の権限が要求されます：
     • https://www.googleapis.com/auth/gmail.modify
     • https://www.googleapis.com/auth/gmail.send
   • 認証情報が token.json に保存されます。
   • コンソールに refresh token が表示されます。

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-gmail": {
         "command": "node",
         "args": ["/path/to/google-gmail-mcp-server/index.js"],
         "env": {}
       }
     }
   }
   

5. サーバーの起動:

   npm start
   

💻 使用例

基本的な使用法

メールの一覧表示

{
  "command": "_gmail.list_emails",
  "args": {
    "userId": "me"
  },
  "response": {
    "data": {
      "messages": []
    }
  }
}

メールの検索

{
  "command": "_gmail.search_emails",
  "args": {
    "userId": "me",
    "query": "inbox is:unread label:important"
  },
  "response": {
    "data": {
      "messages": []
    }
  }
}

メールの送信

{
  "command": "_gmail.send_email",
  "args": {
    "userId": "me",
    "email": {
      "to": "recipient@example.com",
      "subject": "Test Email",
      "bodyText": "This is a test email."
    }
  },
  "response": {
    "data": {
      "id": "string"
    }
  }
}

メールの変更

{
  "command": "_gmail.modify_email",
  "args": {
    "userId": "me",
    // 残りのコードは省略されていましたが、元のまま続きます
  }
}