search_messages

iMessage / Messages · macOS

Effect: read (strongest supported action). Status: gated.

Gated means the tool requires an installed app, a connected account, permission, or runtime availability. Check those requirements on the listed platform before using it.

macOS

Purpose

Searches iMessage conversations by content, sender name, or date range.

Required inputs

No required inputs are declared in this platform's schema. Optional selectors and runtime requirements may still apply.

Permissions and confirmation

No explicit confirmation parameter is exposed in this snapshot. This does not grant permission to act: obtain user authorization before any real action.

Use only the apps, accounts and resources authorized by the user on this platform. Consult this tool's platform-specific description for its connection and permission requirements; this catalog does not assert additional OAuth scopes or OS entitlements.

Full input schema — macOS

{
  "properties": {
    "from_sender": {
      "description": "Substring of sender name/handle to filter by — only messages THEY sent; 'me' for your own (optional)",
      "type": "string"
    },
    "limit": {
      "description": "Max results (default 30)",
      "type": "integer"
    },
    "query": {
      "description": "Text to search for in message content (optional if from_sender is set)",
      "type": "string"
    },
    "since": {
      "description": "ISO8601 date — only return messages on or after this date (optional, e.g. '2026-04-10' or '2026-04-10T00:00:00Z')",
      "type": "string"
    },
    "until": {
      "description": "ISO8601 date or datetime — only return messages on or before it (optional). Inclusive when only a date is given: 2026-10-02 returns the messages of October 2 too (the day is counted in UTC, like the dates returned). With a time, the range ends at that instant. Combine with 'since' to search a date range with no text query.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Documentation example

Do not execute this example. These concrete inputs refer to a fictional demonstration dataset. Resolve real handles and obtain user authorization before any real call.

{
  "limit": 5,
  "query": "launch checklist"
}