MAPS_SEARCH
Search for a location or directions in Apple Maps.
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 | Search term or address |
is_directions | boolean | — | Whether to search for directions |
How to use it
You normally trigger this by describing what you want in chat — the agent selects MAPS_SEARCH automatically. For example:
Try saying
“use mac system tools to maps …”
In a workflow
As a step in a multi-step workflow DAG:
json
{
"id": "s1",
"agent": "mac_system_tools",
"action": "MAPS_SEARCH",
"args": {
"query": "example query",
"is_directions": true
},
"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":"MAPS_SEARCH","args":{"query":"example query","is_directions":true}}'Part of the mac_system_tools plugin. Browse the full Plugin & Tool Catalog or the relevant feature guide.