imessage-tools은(는) 무엇을 하나요?
Claude Code 및 OpenAI Codex CLI용 iMessage 플러그인 — AI 에이전트가 메시지를 읽고, 검색하고, 전송할 수 있습니다.
개요
이 플러그인은 AI 에이전트가 macOS의 iMessage 데이터베이스와 상호 작용할 수 있도록 합니다. 대화를 읽고, 특정 메시지를 검색하고, iMessage를 통해 자동으로 메시지를 보낼 수 있습니다.
기능
- 메시지 읽기: 특정 연락처 또는 대화의 최근 메시지를 가져옵니다.
- 메시지 검색: 키워드, 연락처, 날짜 범위로 메시지를 검색합니다.
- 메시지 전송: iMessage를 통해 연락처 또는 그룹에 새 메시지를 보냅니다.
- 대화 목록: 모든 활성 대화를 나열합니다.
요구 사항
- macOS (필수)
- iMessage가 Apple ID로 설정 및 로그인되어 있어야 함
- 디스크 전체 접근 권한 (iMessage 데이터베이스에 접근하기 위해 필요)
설치
Claude Code
claude add tools --from benelser/imessage-tools
OpenAI Codex CLI
codex add tools --from benelser/imessage-tools
또는 수동으로 ~/.claude/skills/ 또는 ~/.codex/skills/ 디렉토리에 복사합니다.
사용법
메시지 읽기
에이전트는 다음 명령을 사용하여 최근 메시지를 읽을 수 있습니다:
imessage-tools search --limit 10
특정 연락처 검색
imessage-tools search --contact "John Appleseed"
메시지 전송
imessage-tools send --contact "John Appleseed" --message "안녕하세요! Claude Code에서 보낸 메시지입니다."
보안 및 개인정보 보호
- 모든 작업은 데이터베이스에 직접 접근하기 전에 사용자 승인을 요청합니다.
- 메시지는 로컬에서만 처리되며 외부 서비스로 전송되지 않습니다.
- AI 에이전트가 민감한 정보를 보내거나 접근하는 것을 방지하기 위해 보호 장치가 마련되어 있습니다.
- 전체 디스크 접근 권한이 필요하며, 시스템 설정에서 부여해야 합니다.
문제 해결
iMessage 데이터베이스에 접근하는 데 문제가 있는 경우:
- 시스템 설정 > 개인정보 보호 및 보안 > 전체 디스크 접근 권한으로 이동합니다.
- 터미널 앱(또는 Claude Code/Codex CLI가 실행 중인 앱)이 목록에 추가되어 있는지 확인합니다.
- 변경 사항을 적용하려면 터미널 앱을 다시 시작합니다.
라이선스
MIT