Guide

CLI の使い方ガイド — インストールから設定まで

Nylas CLI を 2 分以内にセットアップ。無料の Nylas アカウントを作成し、ダッシュボードから API キーを取得して nylas auth config を実行。ブラウザ認証フロー不要で、すぐにメール・カレンダー・連絡先を操作できます。

Written by Prem Keshari Senior SRE

Reviewed by Caleb Geene

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

Nylas CLI のインストール方法

Nylas CLI は 12 MB の単一スタティックバイナリで、ランタイム依存なしでインストールできます。プラットフォームに合った方法を選んでください。いずれの方法も CPU アーキテクチャ（x86_64 または arm64）を自動検出し、GitHub から正しいビルドをダウンロードして SHA-256 チェックサムで検証します。ほとんどの接続環境で 30 秒以内にインストールが完了します。

Homebrew（macOS・Linux）

Homebrew formula は nylas/nylas-cli リポジトリをタップし、最新の安定版リリースを固定します。brew upgrade を実行すれば自動的にアップグレードされます。

brew install nylas/nylas-cli/nylas

シェルスクリプト（macOS・Linux・WSL）

シェルインストーラーは WSL を含むあらゆる POSIX システムで動作します。バイナリを ~/.config/nylas/bin に書き込み、シェルプロファイルに追加する PATH エクスポート行を表示します。

curl -fsSL https://cli.nylas.com/install.sh | bash

PowerShell（Windows）

PowerShell インストーラーは Windows バイナリをダウンロードし、ユーザーレベルの PATH にインストールディレクトリを追加します。Windows 10 以降に搭載された PowerShell 5.1 以降が必要です。

irm https://cli.nylas.com/install.ps1 | iex

Go

ソースからビルドするには Go 1.23 以降が必要です。バイナリは $GOPATH/bin ディレクトリに配置されます。

go install github.com/nylas/cli/cmd/nylas@latest

いずれの方法でインストールした後も、バージョンを表示してバイナリが PATH にあることを確認してください：

nylas --version

Nylas CLI のセットアップ方法

最速のセットアップ方法は、Nylas Dashboard から API キーを取得する方法です。5 ステップ、2 分以内、ブラウザ認証フロー不要です。

ステップ 1：Nylas アカウントの作成

dashboard-v3.nylas.com でサインアップします。無料枠には接続アカウント 5 つが含まれ、個人利用やテストに十分です。Google、Microsoft、GitHub の SSO でサインアップできます。

ステップ 2：アプリケーションの作成

ダッシュボードで All apps → Create new app に進みます。名前を入力し、リージョン（US または EU）を選択します。各アプリケーションは Gmail、Outlook、Exchange、Yahoo、iCloud、IMAP の接続メールアカウント（グラントと呼びます）を無制限に保持できます。

ステップ 3：API キーの取得

ダッシュボードでアプリケーションを開き、API Keys セクションに移動します。Create new key をクリックしてキーをコピーします。キーは nyl_ で始まり、次のステップで CLI に貼り付けます。

ステップ 4：メールアカウントの接続

ダッシュボードでアプリケーションの Grants セクションに移動し、Add Account をクリックします。メールプロバイダー（Gmail、Outlook、Exchange、Yahoo、iCloud、IMAP）で認証します。これによりグラント（メールアカウントと Nylas アプリケーション間の接続）が作成されます。

ステップ 5：CLI の設定

nylas auth config を実行し、プロンプトに API キーを貼り付けます。CLI は Nylas API に対してキーを検証し、暗号化して ~/.config/nylas/config.yaml に保存し、接続したグラントを同期します。

nylas auth config

Nylas アプリケーションが EU リージョンにある場合は --region eu を渡します：

nylas auth config --region eu

CLI がキーの保存を確認し、接続されたアカウントを表示します：

Paste your API key:
nyl_••••••••••••••••••••

> API key saved to system keyring
> Set user@gmail.com as default account

これで完了です。受信トレイを一覧表示して動作確認しましょう：

nylas email list

追加のメールアカウントを接続するには？

セットアップ後にアカウントを追加するには、Nylas Dashboard でアプリケーションの Grants セクションを開き、Add Account をクリックします。CLI は次のコマンド実行時に新しいグラントを自動的に検出します。

CLI から直接 OAuth で接続することもできます：

nylas auth login

ブラウザが開いて認証が行われます。Google の OAuth 2.0 ドキュメントによると、アクセストークンは 3,600 秒で期限切れになりますが、CLI が自動更新します。権限付与後にブラウザフローがハングする場合は、ダッシュボードからの接続方法を使ってください。

接続アカウントの管理：

# 接続済みアカウントの一覧
nylas auth list

# アカウントの切り替え
nylas auth switch

1 コマンドでセットアップするには？

nylas init --api-key は、CLI を 1 つの非対話型コマンドで設定します — 4 ステップを実行する対話型ウィザードとは異なり、ブラウザ認証フローも SSO リダイレクトもありません。キーを直接渡すと CLI はすぐに認証されるため、これがヘッドレス環境への近道になります：ブラウザが利用できない CI/CD パイプライン、Docker コンテナ、SSH セッションです。

nylas init --api-key nyl_abc123

EU リージョンのアプリケーションの場合は --region eu を追加：

nylas init --api-key nyl_abc123 --region eu

対話型セットアップウィザードの使い方

nylas init ウィザードは、上記の API キーフローの代替手段です。アカウント作成、アプリケーション選択、API キー生成、グラント同期を 1 回の対話セッションで行います。SSO 認証にブラウザが必要です。

nylas init

SSO プロバイダー選択メニューをスキップするには、フラグを直接渡します：

nylas init --google
nylas init --microsoft
nylas init --github

CLI からアカウントを管理するには？

Nylas CLI は Web ダッシュボードの約 90% の機能を nylas dashboard サブコマンドで提供します。アプリケーションの作成、API キーのローテーション、組織の切り替え、ログイン状態の確認がブラウザを開かずにできます。すべてのサブコマンドがスクリプティング用の --json 出力をサポートしています。

よく使うダッシュボード操作：

# ログイン状態の確認
nylas dashboard status

# アプリケーション一覧
nylas dashboard apps list

# 新規アプリケーション作成
nylas dashboard apps create --name "Production App" --region us

# アプリケーションをアクティブに設定
nylas dashboard apps use app_abc123

# 新しい API キーの生成
nylas dashboard apps apikeys create

# 組織の切り替え
nylas dashboard orgs switch

メール・カレンダー・連絡先の使い方

Nylas CLI は 72 以上のコマンドを 3 つのコアグループに整理しています：メール（送信、一覧、検索、下書き、添付）、カレンダー（イベント、空き状況、スケジューリング）、連絡先（一覧、検索、グループ）。各グループはスクリプティング用の --json 出力と結果数を制御する --limit をサポートしています。セットアップ後に最もよく使うコマンド：

# メール：一覧、検索、送信
nylas email list --limit 5
nylas email search "quarterly report"
nylas email send --to colleague@company.com --subject "Quick note" --body "See you at 2pm."

# カレンダー：イベント一覧と空き状況確認
nylas calendar events list --days 7
nylas calendar availability check --start 2026-05-12T09:00:00Z --end 2026-05-12T17:00:00Z --participants colleague@company.com

# 連絡先：一覧と検索
nylas contacts list --limit 10
nylas contacts search --query "Alice"
nylas contacts groups list

任意のコマンドに --json を追加すれば、jq にパイプしたりスクリプトに渡したり、AI エージェントに送ったりできる構造化出力が得られます。メール送信ガイドと カレンダーガイドで各グループの詳細を確認できます。

リセットしてやり直すには？

Nylas CLI の設定はすべて ~/.config/nylas/ にローカル保存されます。通常 3〜4 ファイル、合計 2 KB 未満です。リセットすると API 認証情報、Dashboard セッショントークン、認証済みグラント、設定ファイルが削除されますが、Nylas Dashboard 上のデータや接続アカウントには影響しません。アプリケーション、グラント、API キーはクラウド上にそのまま残ります。

ローカル設定をクリアしてセットアップをやり直す：

nylas config reset
nylas init

--force を付けると確認プロンプトをスキップできます。CLI を自動的に再設定するスクリプトで便利です。

次のステップ