OfficeMail CLI for AI — let your AI agent read, send, and manage OfficeMail email and calendar.
npx claudepluginhub nextintelligence-ai/officemail-official --plugin officemailCalendar management via omail CLI — view agenda, create/update/delete events, recurring events, free/busy, RSVP, calendar CRUD, sharing, and raw JMAP calendar methods. Use when the user asks about calendar, scheduling, agenda, or events.
Contacts management via omail CLI — list, search, add, update, delete contacts and list address books. Use when the user asks about contacts, address book, or looking up people.
Email management via omail CLI — send, reply, forward, redirect, triage inbox, read messages, search, move, flag, draft, watch for new mail, and raw JMAP mail methods. Use when the user asks to read, send, search, organize, or manage email.
Set up OfficeMail CLI — OAuth login, manual JMAP configuration, token refresh, auth troubleshooting, multi-profile management, and connection diagnostics (doctor). Use when the user asks to log in, configure auth, fix connection issues, manage multiple accounts, or set up omail for the first time.
Overview and quick reference for OfficeMail CLI (omail). Use when the user asks general questions about omail capabilities, available commands, schema introspection, or environment configuration.
Ultra-compressed communication mode. Cuts ~75% of tokens while keeping full technical accuracy by speaking like a caveman.
OfficeMail 서비스의 공식 마켓플레이스입니다. 메일, 캘린더 등 OfficeMail이 제공하는 서비스를 AI 에이전트에서 사용할 수 있습니다.
AI 에이전트가 OfficeMail 서비스의 이메일과 캘린더를 읽고, 보내고, 관리할 수 있는 Claude Code 플러그인이자 MCP 서버입니다. OfficeMail(Cyrus IMAP + Postfix 기반) 전용이며, 다른 이메일 서비스나 JMAP 서버에서는 동작하지 않습니다.
두 단계로 설치합니다: 마켓플레이스 등록 → 플러그인 설치.
세션 내부:
/plugin marketplace add nextintelligence-ai/officemail-official
또는 CLI:
claude plugin marketplace add nextintelligence-ai/officemail-official
세션 내부:
/plugin install officemail@officemail
또는 CLI:
claude plugin install officemail@officemail
설치 후 세션을 재시작해야 플러그인이 로드됩니다.
새 세션에서 설정 스킬을 실행하세요:
/officemail:omail-setup
Claude Desktop에서 MCP 서버로 사용할 수 있습니다.
릴리즈 페이지에서
플랫폼에 맞는 .mcpb 파일을 다운로드합니다 (officemail-{platform}.mcpb)
더블클릭하면 바이너리와 MCP 서버 설정이 자동으로 설치됩니다
터미널에서 인증을 설정합니다:
omail auth setup --email you@company.com
Claude Desktop을 재시작하면 도구(tools)를 사용할 수 있습니다
/plugin
claude plugin marketplace update officemail
claude plugin update officemail@officemail
업데이트 후 세션을 재시작하면 적용됩니다.
실행파일(omail)도 새 세션 시작 시 훅이 자동으로 업데이트합니다.
Marketplaces 탭에서 officemail의 auto-update를 활성화하면,
Claude Code 시작 시 마켓플레이스 갱신과 플러그인 업데이트가 자동으로 수행됩니다.
써드파티 마켓플레이스는 기본 비활성화이므로 직접 켜야 합니다.
실행파일(omail) 업데이트를 위해 세션 재시작이 필요합니다.
릴리즈 페이지에서
최신 .mcpb 파일을 다운로드하여 더블클릭하면 덮어쓰기 설치됩니다.
세션 내부:
/plugin uninstall officemail
또는 CLI:
claude plugin uninstall officemail
마켓플레이스도 제거하려면:
claude plugin marketplace remove nextintelligence-ai/officemail-official
officemail 항목을 삭제합니다:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json~/.config/officemail/의 설정 파일과 시스템 키체인의 인증 토큰은
CLI, Claude Code 플러그인, Claude Desktop MCP 서버가 공유합니다.
모든 클라이언트를 제거한 후에만 삭제하세요:
# 설정 파일
rm -rf ~/.config/officemail
# 키체인 항목 — macOS (항목이 없을 때까지 반복)
security delete-generic-password -s officemail-cli
# 키체인 항목 — Linux
secret-tool clear service officemail-cli
# 로그 — macOS
rm -rf ~/Library/Logs/officemail
# 로그 — Linux
rm -rf ~/.local/state/officemail
Windows (PowerShell):
# 설정 및 암호화된 토큰
Remove-Item "$env:LOCALAPPDATA\officemail" -Recurse -Force
which omail # 출력 없으면 정상
ls ~/.config/officemail # "No such file or directory"이면 정상
인증 토큰은 플랫폼 보안 저장소(macOS Keychain, Linux Secret Service,
Windows DPAPI)에 저장됩니다. 설정 파일(~/.config/officemail/config.json)에는
토큰이 포함되지 않습니다.
Claude Code 플러그인, Claude Desktop MCP 서버, CLI 모두 같은 인증 정보를
공유하므로 한 곳에서 인증하면 어디서든 사용할 수 있습니다.
omail auth setup --email you@company.com # OAuth 로그인 (브라우저 열림)
omail auth setup # 또는 수동 설정 (JMAP URL + 토큰)
omail doctor # 연결 확인
여러 OfficeMail 계정을 프로필로 관리할 수 있습니다. 기존 단일 계정 설정은 첫 실행 시 자동으로 마이그레이션됩니다.
# 프로필 추가
omail --profile work auth setup --email you@work.com
omail --profile personal auth setup --email you@personal.com
# 프로필 목록 / 전환 / 삭제 / 이름 변경
omail auth list # 모든 프로필 조회
omail auth switch work # 기본 프로필 변경
omail auth remove old-profile # 프로필 삭제
omail auth rename old-name new-name # 프로필 이름 변경
omail auth status # 전체 프로필 연결 상태 확인
# 프로필 별칭 관리
omail auth alias add work w # 별칭 추가
omail auth alias remove work w # 별칭 삭제
omail auth alias list # 모든 별칭 조회
omail auth alias list work # 특정 프로필 별칭 조회
# 디버그 로그 전송
omail auth report support@company.com # 현재 프로필 기준
omail --profile work auth report admin@co.com # 특정 프로필 기준
# 특정 프로필로 명령 실행
omail --profile work mail +triage
omail --profile personal calendar +agenda
MCP 도구에서는 profile 파라미터로 프로필을 지정하거나,
account_switch 도구로 세션 내 기본 프로필을 변경할 수 있습니다.
Intelligent prompt optimization using skill-based architecture. Enriches vague prompts with research-based clarifying questions before Claude Code executes them