Guide

AI コーディングエージェントにメールアドレスを付与する

AI コーディングエージェントはコードの記述、テストのデバッグ、ファイルのリファクタリングができますが、デプロイ通知の送信、確認メールの読み取り、カレンダー招待の確認はできません。Nylas CLI を使えば、Claude Code、Cursor、OpenAI Codex CLI、OpenClaw から Gmail、Outlook、Exchange、Yahoo、iCloud、IMAP の6プロバイダの実際のメールアカウントにアクセスできます。認証は1回、MCP ツールは16個、セットアップはエージェントごとに約2分。

Written by Caleb Geene Director, Site Reliability Engineering

Reviewed by Hazik

Updated May 17, 2026

Verified — CLI 3.1.1 · Gmail, Outlook · last tested April 11, 2026

なぜ AI コーディングエージェントにメールアドレスを付与するのか？

メールの読み書きができる AI コーディングエージェントは、純粋なコード生成では対応できないタスクを実行できるようになります。デプロイ通知の送信、サインアップフローからの OTP コード抽出、コードレビュー後のミーティングスケジュールなどです。メールがあれば、コードだけのエージェントが、リポジトリ外の人やサービスとやり取りできるエージェントに変わります。

エージェントからメールへのワークフローは、開発者の主要パターンになりつつあります。エージェントには、人、サービス、他のエージェントとメッセージを交換するための永続的な手段が必要だからです。多くのソリューションは単一プロバイダにロックされます。Gmail MCP サーバーは Google のみ、Microsoft Graph は Outlook のみで動作します。Nylas CLI は1つの認証フローで6つの主要メールプロバイダすべてに接続し、MCP 互換のあらゆるコーディングエージェントで動作します。

ステップ 1：サインアップ、アカウント接続、CLI 設定

エージェントを接続する前に、少なくとも1つのメールグラントを持つ Nylas アカウントと、API キーで認証された Nylas CLI が必要です。前提条件のフロー全体は約2分で、一度だけ実行すれば済みます。その後接続するすべてのエージェントが同じ認証情報とグラントを再利用します。

1. Nylas にサインアップして API キーを作成

dashboard-v3.nylas.com にアクセスし、無料アカウントを作成して、Settings で API キーを生成してください。Nylas の無料プランでは最大5つの接続アカウントが利用可能です。

2. Grants で少なくとも1つのメールアカウントを接続

Nylas ダッシュボードで Grants に移動し、Gmail、Outlook、Exchange、Yahoo、iCloud、または IMAP アカウントを接続します。これが AI エージェントが使用するメールアドレスになります。Nylas が Google と Microsoft の OAuth フローを処理するため、独自の OAuth アプリを登録する必要はありません。

3. Nylas CLI をインストールして API キーを設定

Nylas CLI はランタイム依存関係のない単一バイナリです。macOS と Linux では Homebrew が最も速いインストール方法です。インストール後、nylas auth config --api-key を実行して API キーをローカルに保存し、nylas auth whoami で接続を確認します。

# インストール（macOS / Linux）
brew install nylas/nylas-cli/nylas

# API キーの設定
nylas auth config --api-key YOUR_NYLAS_API_KEY

# 接続の確認
nylas auth whoami

Windows やシェルスクリプト、Go でのインストールについては入門ガイドをご覧ください。

YOUR_NYLAS_API_KEY を Nylas ダッシュボードで取得したキーに置き換えてください。 Nylas MCP ドキュメントによると、これにより6プロバイダすべてで16個のメール、カレンダー、連絡先ツールにアクセスできるようになります。

ステップ 2a：Claude Code にメールアドレスを付与する

Claude Code は MCP をネイティブサポートしているため、実際のメールアカウントへの接続は1コマンドで完了します。Nylas CLI が MCP サーバー設定を書き込み、Claude Code の設定ファイルで16個のツールすべてを事前承認するため、メール操作ごとに発生するツール別の許可プロンプトがなくなります。

nylas mcp install コマンドは Claude Code の設定ファイルを直接ターゲットにします。~/.claude.json にサーバーエントリを追加し、~/.claude/settings.json に mcp__nylas__* のワイルドカード許可を追加します。

# Claude Code 用の MCP をインストール
nylas mcp install --assistant claude-code

このコマンドを実行したら、Claude Code を再起動して新しい MCP サーバーを読み込みます。16個の Nylas ツールすべてが対話的なプロンプトなしで事前承認されます。以下の自然言語リクエストを試してください：

"最新のメール5件を読んで"
"alice@example.com にデプロイについてメールを送って"
"明日のカレンダーを確認して"

MCP の詳細（利用可能なツール、リージョンエンドポイント、タイムゾーン処理）については、 AI エージェントの MCP 経由メールアクセスガイドをご覧ください。

ステップ 2b：Cursor にメールアドレスを付与する

Cursor は MCP をネイティブサポートしており、Nylas CLI で1コマンドで設定できます。Cursor には2つの接続方法があります：CLI 経由のローカル STDIO サーバーと、CLI 不要のホスト型 HTTP エンドポイントです。どちらも Cursor のエージェントモードに同じ16個のツールを公開します。

ローカル方式は nylas mcp install --assistant cursor を実行し、~/.cursor/mcp.json にサーバーエントリを書き込みます。CLI プロセスがローカル STDIO サーバーとして動作し、Nylas への API コールをすべて処理します。

# Cursor 用の MCP をインストール
nylas mcp install --assistant cursor

インストール実行後、Cursor を再起動し、Settings を開いて Tools & MCP で "nylas" の横に緑のドットが表示されていることを確認してください。

代替方法：ホスト型 MCP サーバー（CLI インストール不要）。 Cursor はストリーマブル HTTP MCP サーバーもサポートしています。この方法は mcp.us.nylas.com の Nylas MCP エンドポイントに直接接続し、ローカルの CLI プロセスが不要になります。以下を ~/.cursor/mcp.json に追加してください：

{
  "mcpServers": {
    "nylas": {
      "type": "streamable-http",
      "url": "https://mcp.us.nylas.com",
      "headers": {
        "Authorization": "Bearer YOUR_NYLAS_API_KEY"
      }
    }
  }
}

YOUR_NYLAS_API_KEY を Nylas ダッシュボードの API キーに置き換えてください。これによりローカルの CLI プロキシを完全にスキップできます。 Nylas MCP ドキュメントでは両方の方法について説明しています。

ステップ 2c：OpenAI Codex CLI にメールアドレスを付与する

OpenAI Codex CLI は MCP サーバーをネイティブサポートしており、3つの接続方法があります：Nylas CLI 経由のローカル STDIO、ホスト型 HTTP エンドポイント、MCP なしの直接シェルコマンドです。 OpenAI Codex MCP ドキュメントによると、Codex はセッション開始時に MCP サーバーを自動的に起動するため、手動プロセスを維持する必要はありません。

オプション A：Nylas CLI 経由のローカル MCP

codex mcp add コマンドで Nylas をローカル STDIO サーバーとして登録します。Codex はこれを ~/.codex/config.toml に保存し、各セッションの開始時にサーバープロセスを起動します。

# Nylas を MCP サーバーとして追加（STDIO）
codex mcp add nylas -- nylas mcp serve

これにより [mcp_servers.nylas] エントリが ~/.codex/config.toml に追加されます。結果の設定は以下のようになります：

# ~/.codex/config.toml
[mcp_servers.nylas]
command = "nylas"
args = ["mcp", "serve"]

オプション B：ホスト型 MCP サーバー（CLI インストール不要）

ホスト型方式は Codex を Nylas MCP エンドポイントに HTTP で直接接続し、ローカルの CLI プロセスを完全にスキップします。Codex は環境変数からベアラートークンを読み取るため、API キーが設定ファイル自体に表示されることはありません。~/.codex/config.toml にサーバーエントリを追加し、シェルプロファイルで NYLAS_API_KEY 環境変数を設定してください。

# ~/.codex/config.toml
[mcp_servers.nylas]
url = "https://mcp.us.nylas.com"
bearer_token_env_var = "NYLAS_API_KEY"

# 環境変数の設定
export NYLAS_API_KEY="your-api-key-here"

オプション C：シェルコマンド（MCP なし）

Codex は MCP なしでも、サンドボックス化されたシェル内で Nylas CLI コマンドを直接実行できます。各コマンドは Codex のサンドボックス内で実行され、実行前にユーザーの承認が必要です。これにより、すべてのアクションに手動確認ステップが追加されます。CLI コマンドはデフォルトでプレーンテキストを返しますが、--json フラグで構造化 JSON を出力でき、Codex がフォローアップの推論に使用できます。

# 最近のメールを読む
nylas email list --limit 10

# 特定のメールを検索
nylas email search "deploy notification"

# メールを送信
nylas email send --to alice@example.com --subject "Deploy complete" --body "v2.4.1 is live."

# 構造化解析用の JSON 出力
nylas email list --limit 5 --json

シェルコマンドを使った構造化ツール定義の構築については、メールツールで LLM エージェントを構築するガイドをご覧ください。

ステップ 2d：OpenClaw にメールアドレスを付与する

OpenClaw は MCP ではなくプラグインシステムを使用するため、セットアップは他の4つのエージェントとは異なります。Nylas プラグインは OpenClaw にネイティブのメール、カレンダー、連絡先ツールを型付きスキーマとマルチアカウントサポートで提供します。インストールは6コマンド：プラグインのインストール、許可、API キーの設定、ゲートウェイの再起動、検証です。

プラグインシステムでは明示的な信頼設定が必要です。プラグインパッケージのインストール後、OpenClaw がエージェントセッションにツールを公開できるよう、plugins.allow と tools.alsoAllow の両方に "nylas" を追加する必要があります。ゲートウェイの再起動により、新しいプラグイン設定が読み込まれます。

# Nylas プラグインのインストール
openclaw plugins install @nylas/openclaw-nylas-plugin

# プラグインを信頼してエージェントセッションにツールを公開
openclaw config set 'plugins.allow' '["nylas"]'
openclaw config set 'tools.alsoAllow' '["nylas"]'

# API キーの設定
openclaw config set 'plugins.entries.nylas.config.apiKey' 'YOUR_NYLAS_API_KEY'

# プラグイン設定を再読み込みするためゲートウェイを再起動
openclaw gateway restart

# プラグインが接続アカウントを確認できるか検証
openclaw plugins list
openclaw run "List my connected email accounts" --plugin nylas

インストール完了後、OpenClaw は自然言語でメールの送信、スレッドの読み取り、カレンダーイベントの管理、連絡先の検索ができます。プラグインは Nylas ダッシュボードから接続済みのすべてのメールアカウントを自動検出するため、アカウントごとの設定は不要です。

セットアップの詳細は OpenClaw Nylas プラグインのインストールガイドをご覧ください。OpenClaw が初めてなら、 OpenClaw CLI セットアップガイドから始めてください。

比較：AI コーディングエージェント間のメールセットアップ

5つの AI コーディングエージェントが Nylas を通じてメールに接続でき、それぞれ異なる設定ファイルと統合方法を使用します。そのうち4つ（Claude Code、Cursor、Codex CLI、Windsurf）はローカル STDIO サーバーまたはホスト型 HTTP エンドポイントを使用する MCP で接続します。OpenClaw は独自のプラグインシステムで接続します。以下の表は各エージェントのセットアップコマンドと設定ファイルの場所をまとめています。

AI コーディングエージェント	統合方式	セットアップコマンド	設定ファイル
Claude Code	MCP (STDIO)	`nylas mcp install --assistant claude-code`	`~/.claude.json`
Cursor	MCP (STDIO or HTTP)	`nylas mcp install --assistant cursor`	`~/.cursor/mcp.json`
OpenAI Codex CLI	MCP (STDIO or HTTP)	`codex mcp add nylas -- nylas mcp serve`	`~/.codex/config.toml`
Windsurf	MCP (STDIO)	`nylas mcp install --assistant windsurf`	Windsurf config
OpenClaw	Plugin	`openclaw plugins install @nylas/openclaw-nylas-plugin`	OpenClaw plugin registry

5つのエージェントすべてが同じ16個のメール、カレンダー、連絡先ツールを利用できます。MCP エージェント（Claude Code、Cursor、Codex、Windsurf）は Nylas MCP サーバーを通じて接続します。OpenClaw はプラグインシステムを通じて接続します。すべての方法が6つのメールプロバイダ（Gmail、Outlook、Exchange、Yahoo、iCloud、IMAP）に対応しています。

メールアクセスでエージェントができること

メールアクセスを持つ AI コーディングエージェントは、通常ならメールクライアントへの切り替えが必要な6カテゴリのタスクを処理できます：通知の送信、確認メールの読み取り、OTP コードの抽出、ミーティングのスケジュール、メール履歴の検索、返信の下書きです。16個の MCP ツールはすべて自然言語の指示で動作し、フラグやコマンド構文は不要です。

デプロイ通知の送信 -- "チームに v2.4.1 が本番環境にデプロイされたことをメールして"
確認メールの読み取り -- "受信箱で AWS サインアップの確認メールを確認して"
OTP コードの抽出 -- "最新のメールから6桁の認証コードを取得して"（AI エージェントのメール ID を参照）
ミーティングのスケジュール -- "来週火曜日の午後2時に alice@company.com と30分のミーティングを予約して"
メール履歴の検索 -- "Q4 の契約に関するすべてのメールを見つけて、主要な決定事項をまとめて"
返信の下書き -- "Sarah の予算に関する質問に、更新された数字で返信を下書きして"

セキュリティとアクセス制御

AI エージェントにメールアクセスを付与するには、意図しない送信や不正なデータアクセスを防ぐためのガードレールが必要です。Nylas CLI と MCP は2段階の送信パターンを適用します：エージェントがまず下書きを作成し、メールがアカウントから送信される前に別の確認ステップで承認します。このパターンはサポートされている5つのエージェントすべてに適用され、すべてのアウトバウンドメールアクションの100%をカバーします。

送信確認が必須。 MCP ツールはメールが実際に送信される前に confirm_send_draft ステップを要求します。エージェントがまず下書きを作成し、あなたが承認します。
ローカル認証情報の保存。 Nylas CLI は OAuth トークンをマシン上に保存します。コマンドを実行しない限り、システム外に出ることはありません。
サンドボックス実行。 Codex CLI はサンドボックス内でシェルコマンドを実行し、各アクションにユーザー承認が必要です。
いつでも取り消し可能。 nylas auth logout で切断、または nylas auth list で接続アカウントを確認できます。

AI エージェントがメールで行ったすべてのアクションの完全な監査ログについては、 AI エージェントアクティビティの監査ガイドをご覧ください。

次のステップ

メールアクセスを設定したら、自然な次のステップはエージェントの送信内容を制御するガードレールの設定、コンプライアンスのためのエージェントアクティビティの監査、Python や TypeScript でのカスタムエージェントワークフローの構築です。以下のガイドは、初期メールアクセスから本番品質のエージェントメールインフラストラクチャまでのライフサイクル全体をカバーしています。

AI エージェントの暴走を防ぐ -- 危険なアウトバウンドをブロックし、自動返信ループをポリシーレイヤーで抑制する封じ込めルール
MCP 経由の AI エージェントメールアクセス -- 16個のツール、リージョンエンドポイント、タイムゾーン処理を含む MCP の詳細解説
ChatGPT Gmail Connector vs MCP -- ホスト型 ChatGPT アプリ、カスタム MCP アプリ、ローカル CLI MCP の比較
MCP メールサーバーセキュリティチェックリスト -- 最小権限、トークン境界、Webhook 検証、書き込み制御
AI エージェント向け MCP vs API -- MCP、直接 API、スキルを選択するためのベンチマークと判断マトリクス
メールツールで LLM エージェントを構築する -- Python と TypeScript でのカスタムエージェント向けサブプロセスパターン
AI エージェントにメールが必要な理由 -- 認証、OTP、監査証跡、マルチスレッド会話
AI エージェントアクティビティの監査 -- Claude Code、Copilot、MCP エージェントが実行するすべてのアクションを追跡
AI エージェントのメール ID を作成する -- あなたのメールボックスを共有する代わりに、エージェント専用の管理された provider=nylas 受信箱を付与
コマンドリファレンス -- すべてのフラグ、サブコマンド、使用例
Nylas MCP ドキュメント -- 公式サーバーセットアップと API リファレンス