Enables complete email management through Gmail, including sending emails with attachments, reading and searching emails, managing labels and organization, handling drafts, and performing batch operations on multiple emails.
Integrates with Google Cloud for authentication and API access, allowing the MCP server to securely connect to Gmail services through OAuth 2.0 credentials.
Claude AI が Gmail と直接やり取りできるようにする強力な Model Context Protocol (MCP) サーバー。
Gmail MCPサーバーは、ClaudeのようなAIアシスタントが自然言語でGmailと直接やり取りできるようにする包括的な実装です。メール管理のための豊富なツールセットを公開し、会話型AIと受信トレイのシームレスな統合を実現します。
credentials.jsonとしてダウンロードします。認証するにはサーバーを 1 回実行します。
ブラウザウィンドウが開き、Googleアカウントでの認証を求められます。認証後、 token.jsonファイルが作成され、今後使用するために保存されます。
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json注: "/absolute/path/to/gmail-mcp-server/gmail_server.py"を、クローンしたリポジトリ内のgmail_server.pyファイルへの実際の絶対パスに置き換えます。
Gmail MCP サーバーは、Claude に次のツールを公開します。
send_email - テキスト/HTMLコンテンツを含む基本的なメールを送信するsend_email_with_attachment - ファイルを添付したメールを送信するsend_email_with_multiple_attachments - 複数の添付ファイル付きのメールを送信するread_email - IDで特定のメールの内容を読むget_unread_emails - 未読メールのリストを取得するget_important_emails - 重要とマークされたメールを取得するget_emails_with_attachments - 添付ファイルのあるメールを取得するget_recent_emails - 過去X日間のメールを取得するsearch_emails - Gmail のクエリ構文を使用してメールを検索しますget_email_labels - Gmailのすべてのラベル/フォルダを一覧表示するcreate_email_label - 新しいラベルを作成するdelete_email_label - 既存のラベルを削除するlabel_email - メールにラベルを適用するremove_email_label - メールからラベルを削除するmark_as_read - メールを既読にするmark_as_unread - メールを未読としてマークするdelete_email - メールをゴミ箱に移動するcreate_email_draft - 新しいメールの下書きを作成するupdate_email_draft - 既存の下書きを更新するlist_email_drafts - 利用可能な下書きを一覧表示するsend_draft - 既存の下書きを送信するbatch_apply_label - 複数のメールにラベルを適用するbatch_delete_emails - 複数のメールをゴミ箱に移動するget_email_profile - Gmail プロフィール情報を取得するsummarize_recent_emails - 最近のメールの要約を作成する以下に、Claude に対するプロンプトの例を示します。
サーバーはカスタマイズのために複数の環境変数をサポートしています。
| 変数 | 説明 |
|---|---|
GMAIL_TOKEN_PATH | OAuth トークンを保存するためのカスタムパス |
GMAIL_CREDENTIALS_PATH | OAuth 認証情報へのカスタムパス |
GOOGLE_CLIENT_ID | OAuth クライアント ID (資格情報ファイルの代替) |
GOOGLE_CLIENT_SECRET | OAuth クライアント シークレット (資格情報ファイルの代替) |
MCP_PORT | SSEトランスポートのポート（デフォルト: 3000） |
DEBUG | デバッグモードを有効にする（ trueまたはfalse ） |
サーバーは、HTTP ベースの統合のために SSE (Server-Sent Events) モードで実行できます。
これにより、指定されたポート (デフォルト: 3000) でサーバーが起動し、HTTP 経由でアクセスできるようになります。
貢献を歓迎します！お気軽にプルリクエストを送信してください。
git checkout -b feature/amazing-feature ）git commit -m 'Add some amazing feature' )git push origin feature/amazing-feature )このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。
This server cannot be installed
Claude AI が Gmail と対話できるようにし、自然言語コマンドによるメールの送信、読み取り、検索、ラベル付け、下書き管理、バッチ操作をサポートするモデル コンテキスト プロトコル サーバーです。