gmail-mcp-server

このGmailサーバは、モデルコンテキストプロトコル(MCP)を利用して、ユーザーがGmailを通じてメールの送信、削除、読み取り、下書き、返信を行うことを可能にします。ユーザーの操作を促すことで、安全性を確保しています。

GitHubスター

59

ユーザー評価

未評価

お気に入り

0

閲覧数

16

フォーク

32

イシュー

3

インストール方法
難易度
中級
推定所要時間
10-20
必要な環境
Python 3.6以上
Gmail APIの有効化

インストール方法

インストール方法

前提条件

必要なソフトウェアとバージョンを明記してください。
Python: 3.6以上
Gmail API: 有効化済み

インストール手順

1. リポジトリのクローン

bash
git clone https://github.com/jasonsum/gmail-mcp-server
cd gmail-mcp-server

2. 依存関係のインストール

bash
pip install -r requirements.txt

3. Gmail API設定

Gmail APIの設定を行い、OAuthクライアントIDを取得します。手順はREADMEを参照してください。

4. サーバーの起動

bash
python server.py --creds-file-path /path/to/your/client_creds.json --token-path /path/to/your/app_tokens.json

トラブルシューティング

よくある問題

問題: サーバーが起動しない 解決策: Pythonのバージョンを確認し、依存関係を再インストールしてください。 問題: 認証エラーが発生する 解決策: OAuth設定を再確認し、正しいファイルパスを指定してください。

設定方法

設定方法

基本設定

Gmail API設定

OAuthクライアントIDのJSONファイルを指定する必要があります。以下のようにサーバーを起動します:
bash
python server.py --creds-file-path /path/to/your/client_creds.json --token-path /path/to/your/app_tokens.json

詳細設定

セキュリティ設定

OAuthキーは安全な場所に保存し、適切なアクセス権限を設定します。
トークンファイルのパスも安全に管理します。

パフォーマンス調整

必要に応じて、タイムアウトやリトライ設定を調整します。

使用例

使用例

基本的な使用方法

メール送信の例

python
import requests

response = requests.post('http://localhost:5000/send-email', json={
    'recipient_id': 'example@example.com',
    'subject': 'Test Email',
    'message': 'This is a test email.'
})
print(response.json())

未読メールの取得

python
response = requests.get('http://localhost:5000/get-unread-emails')
print(response.json())

使用ケース

特定の受信者にメールを送信する際に、send-emailツールを使用する。
受信トレイから不要なメールを削除するために、trash-emailツールを利用する。
未読のメールを一覧表示し、重要なメールを優先的に確認する。
特定のメールを読み取り、内容を確認した後に返信する。
メールをブラウザで開いて、詳細な内容を確認する。

追加リソース