---
title: "Search Contacts"
description: "Local-first visual environment for building and running AI workflows. Build agents visually, deploy anywhere, privacy by design."
canonical: https://docs.nodetool.ai/nodes/lib/apple/searchcontacts
markdown: https://docs.nodetool.ai/nodes/lib/apple/searchcontacts.md
product: NodeTool
source: https://github.com/nodetool-ai/nodetool/blob/main/docs/nodes/lib/apple/searchcontacts.md
---

# Search Contacts

**Type:** `lib.apple.SearchContacts`

**Namespace:** `lib.apple`

## Description

Search macOS Contacts via AppleScript.
    contacts, search, address book, macos

## Properties

| Property | Type | Description | Default |
|----------|------|-------------|---------|
| query | `str` | Substring to match against name/email/phone | `` |
| limit | `int` | Maximum results | `10` |

## Outputs

| Output | Type | Description |
|--------|------|-------------|
| contacts | `list` |  |

## Related Nodes

Browse other nodes in the [lib.apple](./) namespace.