/ 디렉터리 / 플레이그라운드 / mac_messages_mcp
← 모든 서버 ↗ GitHub
● 커뮤니티 carterlasalle ⚡ 바로 사용

mac_messages_mcp

제작: carterlasalle · carterlasalle/mac_messages_mcp

Read, search, and send iMessages and SMS from Claude — smart delivery auto-selects iMessage or SMS/RCS for each recipient.

mac_messages_mcp is a Python MCP server that bridges macOS Messages app with AI assistants. It can read messages with contact filtering and fuzzy search, send messages with automatic iMessage/SMS detection, check iMessage availability for recipients, process attachments, and handle group chats. Requires Full Disk Access on macOS for database access.

▶ 데모 보기 📦 설치 💡 사용 사례

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

mac-messages-mcp-2.replay ▶ 준비됨
0/0

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "mac-messages-mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/carterlasalle/mac_messages_mcp"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "mac-messages-mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/carterlasalle/mac_messages_mcp"
      ]
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "mac-messages-mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/carterlasalle/mac_messages_mcp"
      ]
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mac-messages-mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/carterlasalle/mac_messages_mcp"
      ]
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "mac-messages-mcp-2",
      "command": "TODO",
      "args": [
        "See README: https://github.com/carterlasalle/mac_messages_mcp"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json
{
  "context_servers": {
    "mac-messages-mcp-2": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/carterlasalle/mac_messages_mcp"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add mac-messages-mcp-2 -- TODO 'See README: https://github.com/carterlasalle/mac_messages_mcp'

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: mac_messages_mcp

How to search your iMessage history with AI assistance

👤 Mac users who want to find specific conversations or information ⏱ ~5 min beginner

언제 쓸까: You need to find a message from weeks ago but can't remember who sent it or when.

사전 조건
  • Full Disk Access granted — System Settings → Privacy & Security → Full Disk Access → add Terminal or your MCP host
  • mac-messages-mcp installed — uvx mac-messages-mcp or uv pip install mac-messages-mcp
흐름
  1. Search messages
    Search my messages for conversations about 'dinner reservation' in the last 2 weeks. Show who sent them and the full context.✓ 복사됨
    → Matching messages with sender, timestamps, and surrounding context
  2. Get recent from a contact
    Show me my last 20 messages with John Smith.✓ 복사됨
    → Conversation thread with timestamps

결과: Found the specific message or conversation you were looking for.

함정
  • Full Disk Access not granted — The MCP server can't read the Messages database without this permission. Grant it in System Settings.

Send messages to contacts using Claude

👤 Mac users who want to send messages hands-free ⏱ ~2 min beginner

언제 쓸까: You want to compose and send messages through Claude.

사전 조건
  • mac-messages-mcp with Full Disk Access — Set up as above
흐름
  1. Check iMessage availability
    Can I reach +1-555-0123 via iMessage?✓ 복사됨
    → Availability status (iMessage or SMS)
  2. Send a message
    Send a message to Mom saying 'Running 15 minutes late, see you soon!'✓ 복사됨
    → Message sent confirmation with delivery method

결과: Message delivered via the appropriate channel.

함정
  • Contact names may be ambiguous — Use phone numbers or email addresses for precise targeting

조합

다른 MCP와 조합해 10배 효율

mac-messages-mcp-2 + filesystem

Export message conversations to text files for backup

Export my last month's messages with the 'Family' group chat to ~/messages-backup/family.txt.✓ 복사됨

도구

이 MCP가 노출하는 것

도구입력언제 호출비용
send_message recipient: str, content: str Send a message via iMessage or SMS 0
get_recent_messages contact?: str, limit?: int, time_range?: str Retrieve recent messages with optional filters 0
check_imessage_availability recipient: str Check if a recipient can receive iMessage 0

비용 및 제한

운영 비용

API 쿼터
N/A — reads local macOS Messages database
호출당 토큰
200–1000 tokens per query
금액
Free — standard iMessage/SMS rates apply for sending
팁
Use time-based filters to limit search scope and reduce token usage.

보안

권한, 시크릿, 파급범위

최소 스코프: Full Disk Access on macOS
자격 증명 저장: No credentials needed — accesses local Messages database directly
데이터 외부 송신: Reads from local ~/Library/Messages/chat.db. Sending goes through macOS Messages framework.

문제 해결

자주 발생하는 오류와 해결

Permission denied reading Messages database

Grant Full Disk Access to Terminal (or your MCP host app) in System Settings → Privacy & Security → Full Disk Access.

확인: ls ~/Library/Messages/chat.db
Contact not found

Use phone number or email instead of display name. Fuzzy matching may not find all contacts.

확인: Try with the exact phone number
Message fails to send

Ensure Messages.app is configured and signed into your Apple ID. The MCP server uses macOS frameworks to send.

확인: Try sending a message manually from Messages.app

대안

mac_messages_mcp 다른 것과 비교

대안언제 쓰나단점/장점
applescript-mcpYou want broader macOS control beyond just MessagesCan do everything plus more, but with full system access risks

더 보기

리소스

📖 GitHub에서 공식 README 읽기

🐙 열린 이슈 보기

🔍 400+ MCP 서버 및 Skills 전체 보기