MCP Gmail Server

JavaベースのGmail MCPサーバーで、Claude Desktopを通じて自然言語でメールを検索する機能を実現します。トピック別の検索やメール内容の読み取りに対応し、OAuth2セキュリティ認証を使用しています。

通信ツール開発者ツール #メール検索 #自然言語 #Gmail統合 #セキュリティ認証 .Java

スコア : 2ポイント

ダウンロード数 : 12

更新時間 : 2025-04-29

Gmail MCPサーバーとは？

Gmail MCPサーバーはJavaベースのツールで、ユーザーが自然言語でGmailメールを検索できます。Gmail APIを利用してメールを検索し、Claude Desktopを通じてやり取りします。

Gmail MCPサーバーの使い方は？

サーバーを起動し、Claude Desktopを設定するだけで、自然言語でメールを検索できます。

適用シナリオ

Gmailメールを迅速に検索して閲覧する必要がある個人やチームに適しています。例えば、特定のトピックのメールを検索したり、過去の記録を確認したりする場合に便利です。

主な機能

メール検索キーワード、送信者、日付などの条件でメールを検索できます。

メール読み取り指定したメールの完全な内容（件名、送信者、本文を含む）を読み取ることができます。

OAuth2セキュリティ認証最小限の権限（読み取り専用）のOAuth2認証を使用して、アカウントのセキュリティを確保します。

Claude Desktop統合標準入出力インターフェースを通じてClaude Desktopとシームレスに接続します。

利点と制限

利点

自然言語での検索に対応しており、操作が簡単で使いやすい。

最小限の権限のOAuth2認証を採用しているため、アカウントのセキュリティが保護される。

検索要求に迅速に応答し、作業効率を向上させる。

Claude Desktopと深く統合されており、ユーザー体験が向上する。

制限

Google CloudプロジェクトとOAuth2資格情報の設定が必要です。

Gmail APIのレート制限の影響を受けるため、検索頻度が制限される場合があります。

新しいメールの送信やその他の高度な機能はサポートされていません。

使い方

依存環境のインストール

Java 17とMavenがインストールされていることを確認してください。

Google Cloud資格情報の作成

Google Cloud ConsoleでGmail APIを有効にし、OAuth2資格情報ファイルをダウンロードしてください。

サーバーの起動

Gmail MCPサーバーを起動し、OAuth2認証プロセスが完了するのを待ちます。

Claude Desktopの設定

Claude DesktopにGmail MCPサーバーの設定を追加します。

使用例

プロジェクトの締切日に関するメールを検索するユーザーは自然言語で検索することで、直近3か月以内のプロジェクトの締切日に関するメールを見つけることができます。

特定のメールを読むユーザーはメールIDを指定することで、メールの完全な内容を閲覧できます。

よくある質問

認証に失敗した場合はどうすればいいですか？

検索速度が遅い場合はどうすればいいですか？

Claude Desktopの設定を更新するにはどうすればいいですか？

🚀 Gmail MCP サーバー

このGmail MCPサーバーは、自然言語指令を通じてGmailアカウントとの対話を可能にし、メールの検索や閲覧をサポートしています。

🚀 クイックスタート

Gmail APIキーとOAuthの認証情報を src/main/resources/credentials.json ファイルに設定し、JVMシステムプロパティ -Dgmail.credentials.path=src/main/resources を正しく設定してください。サーバーを起動する前に、以下の認証手順を完了させてください。

プロジェクトを作成し、Gmail APIを有効にします。
Cloud Platform APIサービスを有効にします。
OAuth認証情報を作成します。

✨ 主な機能

メール検索

自然言語またはクエリ文字列でメールを検索できます。以下の操作をサポートしています。

searchEmails(query: String) -> List<Email>

メール閲覧

メールIDに基づいてメールの全文を読み取ります。

readEmail(emailId: String) -> Email

📦 インストール

credentials.json：Gmail APIの認証情報を含むファイルです。
src/main/resources/：設定ファイルがこのディレクトリにあることを確認してください。
-Dgmail.credentials.path=src/main/resources：JVMシステムプロパティを設定します。

💻 使用例

基本的な使用法

件名での検索：
```
過去1か月間の予算承認に関するメールを表示します。
```
これは次のように変換されます：searchEmails("budget approvals after:2025-03-01 before:2025-04-01")
送信者での検索：
```
alice@example.com から送信された会議計画に関するメールを探します。
```
これは次のように変換されます：searchEmails("from:alice@example.com conference planning")

📚 ドキュメント

ベストプラクティス

セキュリティ：
- 最小限のアクセス権限 gmail.readonly を使用してアクセスを制限します。
- 認証情報ファイルとトークンを安全な場所に保存し、.gitignore で除外します。
エラーハンドリング：
- 無効なリクエストやAPIエラーに対してJSON-RPCエラーレスポンスを返します。
- SLF4J/Logbackを使用して詳細なログを記録し、デバッグを支援します。

トラブルシューティング

認証エラー：
- credentials.json ファイルが src/main/resources/ ディレクトリにあることを確認してください。
- ~/.gmail-mcp/tokens を削除し、再度認証を行います。

セキュリティに関する考慮事項

認証情報：credentials.json と ~/.gmail-mcp/tokens が誤ってバージョン管理システムにコミットされないようにしてください。
OAuth2：継続的なトークンアクセスのために offline アクセスタイプを使用し、Google Cloudコンソールのアクティビティログを定期的に確認します。

サーバーの拡張

機能追加：GmailMcpServer.java を拡張して、labelEmail や sendEmail などの追加機能を含めることができます（追加のアクセス範囲が必要です）。
リモートデプロイ：SSEまたはWebSocketを使用してクラウドデプロイを行います（例：Spring WebFluxを使用）。
キャッシュ：Caffeineなどのメモリストレージを使用して、一般的なクエリのキャッシュ機構を実装します。