outlook-cli-skill은(는) 무엇을 하나요?
Outlook 이메일을 AI 스킬로 변환하세요 — MCP 서버가 필요 없습니다. 모든 AI 에이전트를 위한 경량 OAuth CLI + curl 기반 스킬 파일입니다.
개요
이 스킬은 Microsoft Outlook API를 통해 이메일에 접근할 수 있는 간단한 CLI 도구와 스킬 파일을 제공합니다. 주요 기능:
- 메일함 읽기: 받은 편지함의 최근 이메일 목록 조회
- 이메일 검색: 키워드, 발신자, 날짜 범위로 검색
- 이메일 본문 가져오기: 특정 이메일의 전체 내용 확인
- OAuth 인증: CLI 도구를 통해 간편한 로그인 및 토큰 관리
지원 플랫폼
- Claude Code
- Cursor
- Codex
- 모든 커스텀 AI 에이전트
설치 및 설정
1. CLI 도구 설치
# npm을 통해 전역 설치
npm install -g outlook-cli-skill
# 또는 yarn 사용
yarn global add outlook-cli-skill
2. OAuth 인증
# 인증 시작 (브라우저에서 Microsoft 로그인)
outlook-cli auth login
# 인증 상태 확인
outlook-cli auth status
3. API 사용 예시
# 최근 10개 이메일 가져오기
outlook-cli emails list --top 10
# 특정 키워드로 검색
outlook-cli emails search --query "중요 회의"
# 특정 이메일 본문 가져오기
outlook-cli emails get --id "message-id-here"
스킬 파일 사용법
AI 에이전트에 스킬 파일을 추가하려면:
skills/outlook디렉토리를 생성합니다.- 다음 스킬 파일을 다운로드하거나 생성합니다:
read-emails.md: 메일함 읽기 스킬search-emails.md: 이메일 검색 스킬get-email-body.md: 이메일 본문 가져오기 스킬
- AI 에이전트 설정에서 스킬 디렉토리를 지정합니다.
환경 변수
| 변수명 | 설명 | 필수 여부 |
|---|---|---|
OUTLOOK_CLIENT_ID | Microsoft 앱 클라이언트 ID | 필수 |
OUTLOOK_CLIENT_SECRET | Microsoft 앱 클라이언트 시크릿 | 필수 |
OUTLOOK_TENANT_ID | 테넌트 ID (개인 계정은 common) | 선택 |
curl 예시 (스킬 파일 내부)
# OAuth 토큰 확인
TOKEN=$(outlook-cli auth token)
# 최근 이메일 가져오기
curl -H "Authorization: Bearer $TOKEN" \
"https://graph.microsoft.com/v1.0/me/messages?$top=10&$select=subject,from,receivedDateTime"
# 특정 이메일 본문 가져오기
curl -H "Authorization: Bearer $TOKEN" \
"https://graph.microsoft.com/v1.0/me/messages/{message-id}/?$expand=body"
라이선스
MIT