mac-messages-mcp

Get recent messages from the Messages app.

Args:
    hours: Number of hours to look back (default: 24)
    contact: Filter by contact name, phone number, or email (optional)
            Use "contact:N" to select a specific contact from previous matches

Send a message using the Messages app.

Args:
    recipient: Phone number, email, contact name, or "contact:N" to select from matches
              For example, "contact:1" selects the first contact from a previous search
    message: Message text to send
    group_chat: Whether to send to a group chat (uses chat ID instead of buddy)

Find a contact by name using fuzzy matching.

Args:
    name: The name to search for

Check if a recipient has iMessage available.

This tool helps determine whether to send via iMessage or SMS/RCS.
Useful for debugging delivery issues or choosing the right service.

Args:
    recipient: Phone number or email to check for iMessage availability

Fuzzy search for messages containing the search_term within the last N hours.
Returns messages that match the search term with a similarity score.

Args:
    search_term: The text to search for in messages.
    hours: How many hours back to search (default 24). Must be positive.
    threshold: Similarity threshold for matching (0.0 to 1.0, default 0.6). Lower is more lenient.