carterlasalle/mac_messages_mcp
If you are the rightful owner of mac_messages_mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
Mac Messages MCP is a Python bridge for interacting with the macOS Messages app using the Multiple Context Protocol (MCP).
Tools
Functions exposed to the LLM to take actions
tool_get_recent_messages
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
tool_send_message
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)
tool_find_contact
Find a contact by name using fuzzy matching.
Args: name: The name to search for
tool_check_db_access
Diagnose database access issues.
tool_check_contacts
List available contacts in the address book.
tool_check_addressbook
Diagnose AddressBook access issues.
tool_get_chats
List available group chats from the Messages app.
tool_check_imessage_availability
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
tool_fuzzy_search_messages
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.
Prompts
Interactive templates invoked by user choice
No prompts
Resources
Contextual data attached and managed by the client
