← All toolsProductivitymac_mediamacOS only

MEDIA_GET_STATE

Get current playback state from Music or Spotify (whichever is active).

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

This tool takes no parameters.

How to use it

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

Try saying
“media my mac media”

In a workflow

As a step in a multi-step workflow DAG:

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

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