Gongrzhe Gmail MCP Server

🚀 Gmail自動認証MCPサーバー

このサーバーは、Gmail統合のClaudeデスクトップ版のModel Context Protocol (MCP) サーバーで、自動認証機能をサポートしています。これにより、AIアシスタントが自然言語での対話を通じてGmailを管理できるようになります。

🚀 クイックスタート

このGmail自動認証MCPサーバーは、AIアシスタントが自然言語でGmailを管理できるようにするためのものです。以下のセクションでは、機能、インストール方法、使用方法などを詳しく説明します。

✨ 主な機能

• 件名、本文、添付ファイル、受信者を指定してメールを送信する
• IDを使ってメールメッセージを読む
• 様々な条件（件名、送信者、日付範囲）でメールを検索する
• 受信トレイ、送信済み、またはカスタムラベル内のメールを一覧表示する
• メールを既読/未読にする
• メールを別のラベル/フォルダに移動する
• Gmail APIと完全に統合する
• 自動ブラウザ起動をサポートするシンプルなOAuth2認証フロー
• デスクトップ版とWeb版の両方をサポートする
• ローカルで安全に認証情報を保存する

📦 インストール

Smithery CLIを使用したインストール

smith install @gongrzhe/server-gmail-autoauth-mcp

手動インストール

1. このリポジトリをクローンします：

   git clone https://github.com/yourusername/gmail-autoauth-mcp.git
   cd gmail-autoauth-mcp
   

2. 依存関係をインストールします：

   npm install
   

3. サーバーを起動します：

   node index.js
   

💻 使用例

基本的な使用法

Gmail認証情報の設定

config.json ファイルに以下の内容を追加します：

{
  "gmail": {
    "clientId": "your_client_id",
    "clientSecret": "your_client_secret",
    "redirectUri": "http://localhost:3000"
  }
}

Gmailアカウントの認証

以下のコマンドを実行して、Gmailアカウントを認証します：

node authorize.js

指示に従ってOAuthフローを完了します。

メールの送信

{
  "to": ["recipient@example.com"],
  "subject": "Meeting Tomorrow",
  "body": "Hi,\n\nJust a reminder about our meeting tomorrow at 10 AM.\n\nBest regards",
  "cc": ["cc@example.com"],
  "bcc": ["bcc@example.com"]
}

メールの検索

{
  "query": "from:sender@example.com after:2024/01/01",
  "maxResults": 10
}

メールの閲覧

{
  "messageId": "message123"
}

メールの移動

{
  "messageId": "message123",
  "labelIds": ["INBOX", "IMPORTANT"]
}

📚 ドキュメント

セキュリティに関する注意事項

⚠️ 重要提示

• OAuth認証情報はローカル環境 (~/.gmail-mcp) に安全に保存されます。
• サーバーはオフラインアクセスを使用して永続的な認証を維持します。
• 認証情報をバージョン管理システムに共有またはコミットしないでください。
• 未使用のGoogleアカウントの権限を定期的に確認し、取り消してください。
• 認証情報はグローバルに保存されますが、現在のユーザーのみがアクセスできます。

トラブルシューティング

1. OAuth Keysが見つからない場合

   • gcp-oauth.keys.json が現在のディレクトリまたは ~/.gmail-mcp/ に存在することを確認してください。
   • ファイルの権限を確認してください。

2. 認証情報の形式が無効な場合

   • OAuth認証情報ファイルに web または installed の認証情報が含まれていることを確認してください。
   • Webアプリの場合は、リダイレクトURIが正しく設定されていることを確認してください。

3. ポートが既に使用されている場合

   • ポート3000が既に使用されている場合は、解放してください。
   • そのポートを使用しているプロセスを見つけて停止することができます。

🤝 貢献

貢献を歓迎します！Pull Requestを随時送信してください。

📄 ライセンス

このプロジェクトはISCライセンスの下で公開されています。

🆘 サポート

何か問題があったり、質問がある場合は、GitHubリポジトリに問題を登録してください。