Tous les outils

search_messages

iMessage et Messages · macOS

Effet: lecture. État: disponibilité conditionnelle.

«Disponibilité conditionnelle» signifie que l’outil peut dépendre de la version, de la plateforme, des autorisations, du compte ou de la configuration. Il n’est pas forcément actif partout.

macOS

Objectif

Recherche les conversations iMessage par contenu, nom de l'expéditeur ou plage de dates.

Entrées requises

Le schéma de cette plateforme ne déclare aucune entrée requise. Des sélecteurs facultatifs ou des conditions d’exécution peuvent néanmoins exister.

Autorisations et confirmation

Le schéma ne déclare aucun paramètre de confirmation explicite. Cela n’autorise aucune action sans permission : vérifiez l’effet et obtenez une autorisation.

Schéma technique canonique en anglaismacOS
{
  "properties": {
    "from_sender": {
      "description": "Substring of sender name/handle to filter by (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 — only return messages on or before this date (optional). Combine with 'since' to search a date range with no text query.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Exemple documentaire

Exemple de documentation pour search_messages. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

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