carterlasalle/mac_messages_mcp

로컬 MCP 클라이언트에서 macOS 메시지를 읽고, 검색하며, 전송하세요.

퀵 스타트 · 사용 가능한 도구 · 에이전트 기술 · 명령줄 인터페이스 · 보안 · 변경 로그

Claude, Codex, 커서, VS 코드 또는 로컬 MCP 클라이언트를 사용해 검색, 읽기, 그리고 macOS 메시지 앱을 통해 메시지를 보내세요.

Mac Messages MCP는 Mac에서 로컬로 실행됩니다. 메시지 및 연락처를 엽니다 데이터베이스는 읽기 전용으로, 클라이언트가 요청하고 사용하는 데이터만 반환합니다 자동화 Messages.app 클라이언트가 명시적으로 전송 도구를 호출할 때만 적용됩니다.

[! 중요] 이 서버는 macOS 전용입니다. 메시지 읽기에는 Full Disk가 필요합니다 접근 권한. 전송하려면 Mac이 Messages에 로그인하고 권한을 필요로 합니다. 메시지 자동화 앱을 출시합니다.

작동 방식

클라이언트가 읽는 모든 데이터는 로컬 SQLite 데이터베이스에서 가져와서 열어둡니다 읽기 전용입니다. 기계를 떠나는 모든 것은 Messages.app 를 통해 나갑니다, 명시적인 전송 도구 호출 하에 있습니다. 메시지 및 연락처에서 파생된 텍스트는 다음과 같이 펜싱됩니다 모델로 돌아가는 과정에서 신뢰할 수 없는 데이터가 발생했습니다.

능력

Use Claude, Codex, Cursor, VS Code, or any local MCP client to search, read, and send messages through the macOS Messages app.

Mac Messages MCP runs locally on your Mac. It opens the Messages and Contacts databases read-only, returns only the data a client asks for, and uses Messages.app automation only when the client explicitly calls the send tool.

[!IMPORTANT] This server is macOS-only. Reading messages requires Full Disk Access. Sending requires a Mac signed into Messages plus permission for the launching app to automate Messages.

How it works

flowchart LR
    A[MCP client] -->|stdio| B[mac-messages-mcp]
    B --> C{Tool call}
    C -->|read tools| D[(chat.db read-only)]
    C -->|read tools| E[(AddressBook read-only)]
    C -->|send tools| F[Messages.app]
    F --> G[Recipient]
    D --> H[Untrusted-output boundary]
    E --> H
    H --> A

Everything the client reads comes from the local SQLite databases, opened read-only. Everything that leaves the machine goes out through Messages.app, under an explicit send tool call. Message- and contact-derived text is fenced as untrusted data on the way back to the model.

Capabilities