← All toolsProductivitymac_mediamacOS only

Photos Recent

List recent photos from the library.

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

NameTypeRequiredDescription
countinteger-Number of photos to list

How to use it

You normally trigger this by describing what you want in chat; the agent selects PHOTOS_RECENT automatically. For example:

Try saying
“use mac media to photos …”

In a workflow

As a step in a multi-step workflow DAG:

json
{
  "id": "s1",
  "agent": "mac_media",
  "action": "PHOTOS_RECENT",
  "args": {
    "count": 5
  },
  "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":"PHOTOS_RECENT","args":{"count":5}}'

Part of the mac_media plugin. Browse the full Plugin & Tool Catalog or the relevant feature guide.