Reads iMessage conversations and messages stored on macOS.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add imessage -- deno run --allow-read --allow-env --allow-sys --allow-run --allow-ffi jsr:@wyattjoh/imessage-mcp~/.codex/config.toml
[mcp_servers.imessage]
command = "deno"
args = ["run", "--allow-read", "--allow-env", "--allow-sys", "--allow-run", "--allow-ffi", "jsr:@wyattjoh/imessage-mcp"]
# codex mcp add imessage -- deno run --allow-read --allow-env --allow-sys --allow-run --allow-ffi jsr:@wyattjoh/imessage-mcp~/.cursor/mcp.json
{
"mcpServers": {
"imessage": {
"command": "deno",
"args": [
"run",
"--allow-read",
"--allow-env",
"--allow-sys",
"--allow-run",
"--allow-ffi",
"jsr:@wyattjoh/imessage-mcp"
]
}
}
}.vscode/mcp.json
{
"servers": {
"imessage": {
"type": "stdio",
"command": "deno",
"args": [
"run",
"--allow-read",
"--allow-env",
"--allow-sys",
"--allow-run",
"--allow-ffi",
"jsr:@wyattjoh/imessage-mcp"
]
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"imessage": {
"command": "deno",
"args": [
"run",
"--allow-read",
"--allow-env",
"--allow-sys",
"--allow-run",
"--allow-ffi",
"jsr:@wyattjoh/imessage-mcp"
]
}
}
}claude_desktop_config.json
{
"mcpServers": {
"imessage": {
"command": "deno",
"args": [
"run",
"--allow-read",
"--allow-env",
"--allow-sys",
"--allow-run",
"--allow-ffi",
"jsr:@wyattjoh/imessage-mcp"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"imessage": {
"command": "deno",
"args": [
"run",
"--allow-read",
"--allow-env",
"--allow-sys",
"--allow-run",
"--allow-ffi",
"jsr:@wyattjoh/imessage-mcp"
]
}
}
}