CONTACTS_SEARCH
Search for contacts by name.
macOS only
This capability uses native Apple apps and is available in the macOS edition. The Linux editions offer equivalent cross-platform capabilities instead.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | yes | Name or keyword to search for |
How to use it
You normally trigger this by describing what you want in chat — the agent selects CONTACTS_SEARCH automatically. For example:
Try saying
“use mac productivity to contacts …”
In a workflow
As a step in a multi-step workflow DAG:
json
{
"id": "s1",
"agent": "mac_productivity",
"action": "CONTACTS_SEARCH",
"args": {
"query": "example query"
},
"depends_on": [],
"outputs": []
}Direct call
For scripting, call it directly via POST /execute_tool. Every tool returns { success, message, data }.
bash
curl -X POST http://127.0.0.1:8000/execute_tool \
-H "Content-Type: application/json" \
-d '{"tool_name":"CONTACTS_SEARCH","args":{"query":"example query"}}'Part of the mac_productivity plugin. Browse the full Plugin & Tool Catalog or the relevant feature guide.