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

Read, search, and send macOS Messages from any local MCP client. 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