olk — 터미널에서 사용하는 Microsoft Outlook

olk는 Microsoft Graph를 통해 Outlook 메일, 일정, 연락처, 작업, OneDrive를 다루는 스크립트 가능한 CLI 및 MCP 서버입니다. 개인 Outlook.com 계정과 엔터프라이즈 Microsoft 365 계정 모두에서 작동합니다.

설치

brew install rlrghb/tap/olk
# or
go install github.com/rlrghb/olkcli/cmd/olk@latest

npm 패키지는 olkcli이고, 설치되는 명령어는 olk입니다:

npm install -g olkcli

업그레이드 후 macOS가 Keychain 접근을 요청하면 macOS 참고 사항을 확인하세요.

Related MCP server: Microsoft MCP

빠른 시작

olk auth login
olk auth status
olk mail list --json --results-only --select id,subject,from
olk mail search 'from:person@example.com subject:urgent'
olk calendar view --days 7
olk contacts search "Alex"
olk todo lists list
olk drive ls

회사/학교 계정 및 엔터프라이즈 전용 기능의 경우:

olk auth login --enterprise

주요 명령어

모든 명령어와 플래그는 명령어 참조를 확인하세요.

출력 및 스크립팅

결과는 stdout으로 출력되고, 진단 메시지와 프롬프트는 stderr로 출력됩니다.

olk mail list --json --results-only | jq '.[].subject'
olk contacts list --plain

출력 모드는 기본적으로 JSON(--json), TSV(--plain), 정렬된 테이블입니다. --concise를 사용하면 큰 본문/미리보기를 생략하고, 지원되는 경우 --select로 필드를 제한할 수 있습니다. 스크립팅 및 동기화를 참조하세요.

안전 기본값

• 무인 읽기 전용 실행에는 --no-write --no-send --no-input을 사용하세요.

• MCP는 선별된 도구를 노출하며 변경 작업에는 명시적 동의가 필요합니다.

• 외부 메일, 일정, 연락처, 파일 텍스트는 에이전트 안전 소비를 위해 --wrap-untrusted로 감쌀 수 있습니다.

• 리프레시 토큰은 OS 키체인에 저장되고, 액세스 토큰은 메모리에만 보관됩니다.

에이전트를 연결하거나 로그를 공유하기 전에 보안 및 개인정보 보호 가이드를 읽으세요.

문서

• 명령어 참조

• 인증 및 계정

• 스크립팅 및 동기화

• MCP 및 AI 에이전트

• 보안 및 개인정보 보호

• 엔터프라이즈 앱 설정

• 개발 및 릴리스

• 에이전트 지침

기여

make build
make test
make lint

저장소 구조, 검증, CI, 게시 세부 사항은 개발 및 릴리스를 참조하세요.

라이선스

LICENSE를 참조하세요.