imessage-mcp

Claude Code 및 Claude Desktop에 iMessage 데이터를 노출하고 연락처 이름을 자동으로 확인하는 읽기 전용 MCP 서버입니다.

설정

1. 설치

cd ~/workspace/imessage-mcp
python3.12 -m venv .venv
source .venv/bin/activate
pip install -e .

2. 전체 디스크 접근 권한 부여

이 서버는 ~/Library/Messages/chat.db 및 연락처 데이터베이스를 읽어야 합니다. 서버를 실행하는 앱에 **전체 디스크 접근 권한(Full Disk Access)**을 부여하세요:

1. 시스템 설정 → 개인정보 보호 및 보안 → 전체 디스크 접근 권한을 엽니다.

2. Claude Code의 경우: 터미널 앱(예: Terminal, iTerm2, Ghostty)을 추가합니다.

3. Claude Desktop의 경우: Claude 앱을 추가합니다.

3. Claude Code 구성

~/.claude/settings.json에 추가하세요:

{
  "mcpServers": {
    "imessage": {
      "command": "/Users/jaredmoskowitz/workspace/imessage-mcp/.venv/bin/python",
      "args": ["-m", "imessage_mcp"]
    }
  }
}

4. Claude Desktop 구성

~/Library/Application Support/Claude/claude_desktop_config.json에 추가하세요:

{
  "mcpServers": {
    "imessage": {
      "command": "/Users/jaredmoskowitz/workspace/imessage-mcp/.venv/bin/python",
      "args": ["-m", "imessage_mcp"]
    }
  }
}

Related MCP server: imessage-rich-search

도구

list_chats

최근 활동순으로 정렬된 iMessage 채팅 목록을 가져옵니다.

• limit (선택 사항, 기본값 50): 가져올 최대 채팅 수

get_messages

특정 채팅의 메시지를 가져옵니다.

• chat_id (필수): list_chats에서 확인한 채팅 식별자

• limit (선택 사항, 기본값 50): 최대 메시지 수

• since (선택 사항): ISO 날짜 문자열 — 해당 날짜 이후의 메시지만 가져옴

search_messages

모든 채팅에서 키워드가 포함된 메시지를 검색합니다.

• query (필수): 검색할 텍스트

• limit (선택 사항, 기본값 50): 최대 결과 수

사용 예시

"내 그룹 채팅 목록을 보여줘" "Business Ideas 채팅에서 최근 메시지 20개를 가져와" "내 메시지에서 'startup idea'를 검색해줘"