OfficeMail Official Marketplace — AI agent tools for OfficeMail services
npx claudepluginhub nextintelligence-ai/officemail-officialOfficeMail CLI for AI — let your AI agent read, send, and manage OfficeMail email and calendar.
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 login --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
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"이면 정상
인증 정보는 ~/.config/officemail/config.json에 저장됩니다 (chmod 600).
Claude Code 플러그인, Claude Desktop MCP 서버, CLI 모두 같은 파일을 공유하므로
한 곳에서 인증하면 어디서든 사용할 수 있습니다.
omail auth login --email you@company.com # OAuth 로그인 (브라우저 열림)
omail auth setup # 또는 수동 설정 (JMAP URL + 토큰)
omail doctor # 연결 확인
여러 Officemail 계정을 프로필로 관리할 수 있습니다. 기존 단일 계정 설정은 첫 실행 시 자동으로 마이그레이션됩니다.
# 프로필 추가
omail --profile work auth login --email you@work.com
omail --profile personal auth login --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 --profile work mail +triage
omail --profile personal calendar +agenda
MCP 도구에서는 profile 파라미터로 프로필을 지정하거나,
account_switch 도구로 세션 내 기본 프로필을 변경할 수 있습니다.
| 스킬 | 설명 |
|---|---|
omail | 개요, 글로벌 플래그, 종료 코드, 보안 규칙, 스키마 |
omail-setup | 인증 (OAuth/수동), 연결 진단 (doctor) |
omail-mail | 메일 전체: 보내기, 답장, 분류, 읽기, 검색, 이동, 플래그, 초안, 감시 |
omail-calendar | 캘린더 전체: 일정 CRUD, 반복, 알림, RSVP, 공유, 파싱 |
Claude Code에서 자연어로 사용할 수 있습니다:
someone@example.com에게 회의 일정 확인 메일 보내줘"+watch 사용)