search_messages

macOS

Zweck

Durchsucht iMessage-Konversationen nach Inhalt, Absendername oder Datumsbereich.

Erforderliche Eingaben

Das Schema dieser Plattform deklariert keine erforderlichen Eingaben. Optionale Selektoren oder Laufzeitanforderungen können dennoch gelten.

Berechtigungen und Bestätigung

Das Schema deklariert keinen ausdrücklichen Bestätigungsparameter. Das erlaubt keine Handlung ohne Zustimmung; prüfen Sie die Wirkung und holen Sie eine Autorisierung ein.

• Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

{
  "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"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für search_messages. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

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