Mac Messages MCP

{
  "mcpServers": {
    "mac-messages-mcp": {
      "command": "uvx",
      "args": [
        "mac-messages-mcp"
      ],
      "env": {
        "MAC_MESSAGES_REGION": "your-value"
      }
    }
  }
}

claude mcp add --env MAC_MESSAGES_REGION=your-value --transport stdio mac-messages-mcp -- uvx mac-messages-mcp

{
  "mcpServers": {
    "mac-messages-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mac-messages-mcp"
      ],
      "env": {
        "MAC_MESSAGES_REGION": "your-value"
      }
    }
  }
}

{
  "servers": {
    "mac-messages-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mac-messages-mcp"
      ],
      "env": {
        "MAC_MESSAGES_REGION": "your-value"
      }
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

• tool_get_recent_messages

  Read recent messages, filtered by contact, group chat ID, date range, or unread state; page with limit/offset

• tool_fuzzy_search_messages

  Search message bodies by approximate text match, scoped to a contact or chat; defaults to 30 days, or hours=0

• tool_list_conversations

  List every conversation with kind, message count, unread count, and last activity

• tool_wait_for_new_messages

  Block until a message newer than a ROWID cursor arrives, or the timeout expires

• tool_find_contact

  Fuzzy-match a name in Contacts and return phone numbers

• tool_get_chats

  List named group chats and their identifiers

• tool_search_attachments

  Find attachment metadata by date, contact, MIME type, and limit

• tool_search_attachment_contents

  Search inside attachment text/PDF contents by date, contact, and MIME type

• tool_get_attachment

  Fetch one attachment by ID, inline when supported or as a local path

• tool_check_imessage_availability

  Check likely iMessage availability for a phone number or email

• tool_check_db_access

  Diagnose access to ~/Library/Messages/chat.db

• tool_check_contacts

  Return a contact count and a small sample

• tool_check_addressbook

  Diagnose Contacts/AddressBook database access

• tool_send_message

  Send one direct or group message through Messages.app, optionally with file attachments and elicitation approval

• tool_create_contact

  Create one Contacts.app entry with a phone number

• tool_schedule_message

  Queue a message for later delivery while this server process runs

• tool_list_scheduled_messages

  List the in-process scheduled-message queue and its status

• tool_cancel_scheduled_message

  Cancel one pending scheduled message

Use Claude, Codex, Cursor, VS Code, or any local MCP client to search, read, and send messages through the macOS Messages app.

• applescript
• claude
• contacts
• cursor
• imessage
• mac
• macos
• mcp
• mcp-server