Top AI Repos — open-source AI, indexed and scored
Top AI Repos tracks AI repositories on GitHub and answers two different questions about each one: is it moving right now, and would you bet a product on it.
Top AI Repos tracks AI repositories on GitHub and answers two different questions about each one: is it moving right now, and would you bet a product on it.
An MCP server that securely interfaces with your iMessage database via the Model Context Protocol (MCP), allowing LLMs to query and analyze iMessage conversations. It includes robust phone number validation, attachment processing, contact management, group chat handling, and full support for sending and receiving messages.
| Date | Stars |
|---|---|
| 2026-07-31 | 311 |
| 2026-08-02 | 312 |
| 2026-08-06 | 312 |
Today
— stars today
This week
— stars this week
This month
— stars this month
Momentum
0.0
growth rate 0.00%/day
# Mac Messages MCP
Use Claude, Codex, Cursor, VS Code, or any local MCP client to search, read, and
send messages through the macOS Messages app.
[](https://pypi.org/project/mac-messages-mcp/)
[](https://pypi.org/project/mac-messages-mcp/)
[](https://github.com/carterlasalle/mac_messages_mcp/actions/workflows/ci.yml)
[](https://pepy.tech/project/mac-messages-mcp)
[](LICENSE)
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.
## What it can do
- Read recent messages across all conversations or filter by contact or group
chat
- Fuzzy-search message text across a time window, including all available
history
- Find Contacts by approximate name and return send-ready phone numbers
- List named group chats and use their chat IDs for reads or sends
- Send iMessage, with SMS/RCS fallback for eligible phone recipients
- Check whether a recipient appears reachable through iMessage before sending
- Find attachments by date, sender, and MIME type
- Return small images inline, convert HEIC images to PNG, or return a local path
for larger and non-image files
- Diagnose Messages and Contacts database permissions from inside the MCP client
## Quick start
### 1. Install `uv`
```bash
brew install uv
```
Confirm that the launcher is available:
```bash
uvx --version
```
Python 3.10 or newer is required. `uvx` can provision a compatible Python and
installs Mac Messages MCP in an isolated environment, so you do not need to
create a virtual environment first.
### 2. Grant macOS permissions
Open **System Settings → Privacy & Security → Full Disk Access** and enable the
app that will launch the MCP server:
- Claude Desktop, Cursor, VS Code, or the ChatGPT desktop app when configured in
that app
- Terminal, iTerm2, Ghostty, or another terminal when using Claude Code or Codex
CLI from that terminal
Quit and reopen the app after changing Full Disk Access. On the first contact
lookup or send, macOS may separately ask for access to Contacts or permission to
control Messages. Allow those prompts.
Also make sure Messages.app is open, signed in, and already able to send a
normal message.
### 3. Add the server to your MCP client
The server command is the same everywhere:
```text
uvx mac-messages-mcp
```
Choose your client below.
#### Claude Desktop
Open **Claude → Settings → Developer → Edit Config**, then add:
```json
{
"mcpServers": {
"mac-messages": {
"command": "uvx",
"args": ["mac-messages-mcp"]
}
}
}
```
Preserve any other servers already in `claude_desktop_config.json`, save the
file, and restart Claude Desktop.
Claude Desktop also supports installable `.mcpb` extensions. See
[Build the Claude Desktop extension](#build-the-claude-desktop-extension) if you
want to package this repository as one.
#### Claude Code
Add it once at user scope so it is available in every project:
```bash
claude mcp add --transport stdio --scope user mac-messages -- uvx mac-messages-mcp
```
Verify it:
```bash
claude mcp get mac-messages
```
Inside Claude Code, run `/mcp` to inspect the connection and tools.
#### Codex CLI, Codex IDE extension, and ChatGPT desktop app
Codex clients on the same Mac share MCP configuration. Add the server with:
```bash
codex mcp add Excerpt of 15,080 characters
Read on GitHubWould you bet a product on this? Bounded 0–100 and slow moving.
matched fp:18965c7fc6e6913f, topic:mcp, topic:mcp-server, desc:model context protocol