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는 12MB 단일 정적 바이너리로, 런타임 의존성 없이 설치됩니다. 플랫폼에 맞는 방법을 선택하세요. 모든 방법이 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 export 줄을 출력합니다.

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

명령 하나로 설정하는 방법

nylas init --api-key는 비대화형 명령 하나로 CLI를 설정합니다 — 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 키 생성, 그랜트 동기화를 하나의 대화형 세션에서 처리합니다. SSO 인증에 브라우저가 필요합니다.

nylas init

SSO 제공업체 선택 메뉴를 건너뛰려면 플래그를 직접 전달하세요:

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

CLI에서 계정을 관리하는 방법

Nylas CLI는 웹 대시보드 기능의 약 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개 파일, 합계 2KB 미만입니다. 초기화하면 API 인증 정보, Dashboard 세션 토큰, 인증된 그랜트, 설정 파일이 삭제되지만, Nylas Dashboard의 데이터나 서버 측 연결 계정에는 영향을 주지 않습니다. 애플리케이션, 그랜트, API 키는 클라우드에 그대로 남습니다.

로컬 설정을 지우고 다시 설정하기:

nylas config reset
nylas init

--force를 붙이면 확인 프롬프트를 건너뜁니다. CLI를 자동으로 재설정하는 스크립트에서 유용합니다.

다음 단계