Guide

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

Nylas CLI を 2 分以内にセットアップ。nylas init のガイド付きウィザードでアカウント作成からメール接続まで一括完了。既存の 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

インストール後のセットアップ方法

インストール後のセットアップ方法は 2 つあります。新規ユーザーは nylas init を実行します。これは Nylas アカウントの作成、アプリケーションの構築、API キーの生成、最初のメールアカウントの接続を 1 回のセッションで行う対話型ウィザードです。すでに API キーがある場合は nylas auth config を実行してログインします。メールボックスは nylas auth login で追加でき、無料枠では最大 5 アカウントまで接続できます。

nylas init でセットアップするには？

nylas init ウィザードは、新規ユーザーにとって最速の方法です。1 回の対話セッションで 4 つのステップを実行します：Nylas アカウントへのログインまたは作成、アプリケーションの選択または作成、API キーの生成と有効化、既存メールアカウントの同期です。このフローは約 90 秒で完了し、SSO サインインのためにブラウザが 1 度だけ開きます。

nylas init

ウィザードは SSO プロバイダー（Google、Microsoft、GitHub）を尋ね、アプリケーションとキーの作成を経てメールボックスを接続します。プロバイダー選択メニューをスキップするには、フラグを直接渡します：

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

ウィザードが完了すると、アカウントが認証され、メールが接続されます。受信トレイを一覧表示して動作確認しましょう：

nylas email list

既存の API キーでログインするには？

Nylas Dashboard から取得した API キーをすでにお持ちですか？nylas auth config を実行し、プロンプトに貼り付けてログインします — 4 ステップのウィザードを省略できます。CLI は 1 秒以内にキーを検証して暗号化保存し、ブラウザや SSO リダイレクトを必要としません。CI/CD パイプライン、Docker コンテナ、SSH セッションに最適です。

nylas auth config

非対話型セットアップでは、キーをフラグとして渡します。Nylas アプリケーションが EU リージョンにある場合は --region eu を追加します。キーは nyl_ で始まります：

nylas auth config --api-key nyl_abc123
nylas auth config --api-key nyl_abc123 --region eu

ダッシュボードから API キーを取得するには？

Nylas を初めて使うけれどウィザードよりダッシュボードを好む場合は、3 ステップで API キーを生成し、上記の nylas auth config でログインします。無料枠には接続アカウント 5 つが含まれ、クレジットカードは不要です。

  1. サインアップ： dashboard-v3.nylas.com で Google、Microsoft、GitHub の SSO を使ってサインアップします。
  2. アプリケーションの作成 — All apps を開いて新しいアプリを作成し、リージョン（US または EU）を選択します。
  3. API キーの生成 — アプリの API Keys セクションを開き、Create new key をクリックします。キーは nyl_ で始まります。

キーでログインすると CLI はアプリケーションに対して認証されますが、この時点ではメールボックスは接続されていません。nylas auth login で最初のメールアカウントを接続します。これは後でアカウントを追加するときと同じコマンドです（次のセクションで説明します）。

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

メールボックスは nylas auth login で接続します。無料枠では Gmail、Outlook、Exchange、Yahoo、iCloud、IMAP にわたって最大 5 アカウント（グラントと呼びます）まで接続できます。Google が既定のプロバイダーなので、引数なしのコマンドは Google サインインを開始します。他の 5 つのプロバイダーには --provider を渡します。CLI は次のコマンド実行時に新しいグラントを自動的に検出します。

# OAuth プロバイダー（ブラウザが開きます）
nylas auth login --provider google
nylas auth login --provider microsoft
nylas auth login --provider ews

# 認証情報プロバイダー（アプリ固有のパスワード）
nylas auth login --provider icloud
nylas auth login --provider yahoo
nylas auth login --provider imap

Google の OAuth 2.0 ドキュメントによると、アクセストークンは 3,600 秒で期限切れになります。CLI はグラントを保存してトークンを自動更新するため、認証は 1 度だけで済みます。接続済みアカウントの一覧表示と切り替えは次のとおりです：

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

# アクティブなアカウントの切り替え
nylas auth switch

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 を自動的に再設定するスクリプトで便利です。

次のステップ