get_contact

Contactos · macOS

Efecto: lectura. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Obtiene un contacto de la aplicación Contactos de Mac (Contacts.app) por nombre o ID. Pase `name` para buscar directamente por nombre (no es necesario search_contacts primero; si varias personas coinciden, obtendrá una lista compacta para elegir), o `contact_id` para una búsqueda exacta. Para Microsoft 365, use m365_get_contact en su lugar.

Entradas obligatorias

El esquema de esta plataforma no declara entradas obligatorias. Aun así, pueden existir selectores opcionales o requisitos de ejecución.

Permisos y confirmación

El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.

Esquema técnico canónico en inglés — macOS

{
  "properties": {
    "contact_id": {
      "description": "Exact identifier from list_contacts/search_contacts. Provide this OR name.",
      "type": "string"
    },
    "name": {
      "description": "Full or partial contact name — the one-step path. Provide this OR contact_id.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Ejemplo documental

Ejemplo de documentación para get_contact. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

{
  "name": "Alex Rivera"
}