Imessage Mcp

communication MCP Server

macOS-only iMessage MCP server for Claude Code. Direct chat.db read, voice-note transcription, FTS5 search, AppleScript send with draft+confirm. Vault auto-export.

Verified
communicationcommunication
4 views2 stars2 forksMIT

Why This Matters

Discovered via github-topic:model-context-protocol and last synced 1w ago.

Verified
Source
github-topic:model-context-protocol
Stars
2
Last synced
1w ago
Install
Check source

Install

Install instructions not detected yet

Check the source repository for the latest setup steps.

View source instructions
17
Tools
0
Resources
0
Prompts
Standard I/O
Transport

Available Tools (17)

handle

(optional): Phone number or email to filter by

Search

macOS Contacts by name and get phone numbers

chatGuid

(required): The chat GUID

Returns

contact info with phone numbers and email addresses that can be used as handle parameters

Searches

directly in the macOS AddressBook database for better performance and reliability

query

(optional): Text to search for

startDate

(optional): ISO datetime string for start date

endDate

(optional): ISO datetime string for end date

since

older than 2 years → rejected (no deep-history dumps).

Send

a staged draft via Messages.app. Refuses duplicate sends. (Or send via the menu bar app — see below.) |

All

message bodies truncated at ~8 KB with a marker.

lastName

(optional): Last name to search for (e.g., 'Smith'). If omitted, searches across all name fields

limit

(optional): Maximum results (1-200, default: 50)

Get

messages from a specific chat

List

all conversations

offset

(optional): Pagination offset (default: 0)

firstName

(required): First name to search for (e.g., 'John')