thenavidm

Imessage MCP CLI — AI skill for Claude Code

AI community

iMessage MCP server and CLI for Claude Code, Codex and AI agents on a Mac.

How to install Imessage MCP CLI

This entry records only its repository, not the path inside it, so there is no exact command to give. Open thenavidm/imessage-mcp-cli and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Imessage MCP CLI does

iMessage MCP server and CLI for Claude Code, Codex and AI agents on a Mac. 10 tools for an inbox that survives restarts, search across your full history, contact lookup, sending with delivery confirmation, and voice note transcription.

Alternatives in AI

macOS Use — Make Mac apps accessible for AI agents 2k ★
Loushang — AI-native agent harness for coding workflows by python: multi-model LLM orchestration, stateful sessions, tool 1.3k ★
Ataru — High-performance AI memory retrieval for local agent history — a Rust search core (SDK / API / JSON CLI) plus 351 ★

README

iMessage MCP Server & CLI

[![npm](https://img.shields.io/npm/v/@thenavidm%2Fimessage-mcp-cli?color=orange&label=npm)](https://www.npmjs.com/package/@thenavidm/imessage-mcp-cli) [![License](https://img.shields.io/badge/License-MIT-green)](./LICENSE) [![YouTube](https://img.shields.io/badge/YouTube-@thenavidm-red?logo=youtube&logoColor=white)](https://youtube.com/@thenavidm?sub_confirmation=1) [![X](https://img.shields.io/badge/X-@thenavidm-black?logo=x)](https://x.com/thenavidm) [![LinkedIn](https://img.shields.io/badge/LinkedIn-thenavidm-0A66C2?logo=linkedin&logoColor=white)](https://linkedin.com/in/thenavidm)

One install gives you both surfaces, the same 10 tools under the same names, from the same server, so they cannot drift apart.

It reads the Messages database already on your Mac. Nothing is uploaded anywhere.

There is no account to connect and no API key. Full Disk Access is the whole setup.

It can read every conversation in that database, so connect it only to an AI app you trust with your messages.

10 tools. macOS only, because the database exists nowhere else.

Built and maintained by [Navid Moazzez](https://navid.me?utm_source=github&utm_medium=referral&utm_campaign=imessage-mcp-cli&utm_content=readme).

Claude Code using the iMessage MCP server

Two ways to use it

Command line

`imessage-cli` runs every tool as a command. Agents that run commands, like Claude Code, Codex and OpenCode, use it on their own, and you can type the same commands in a terminal, a script or a cron job: