Viewer Pro ships with a built-in MCP server that lets an AI agent read and write the cuelists and setlists in your currently loaded project — listing cues, adding and editing them, building setlists, and attaching Lua scripts to cues — all driven from a chat conversation.
<aside> ✅
Requirements
To setup mcp service, first you will need to enable it in settings.
Simple mode allows only appending cues and tracks. Advanced mode allows full editing of both.
The application comes with a helper that is used by your agent. On mac it can be found at /Applications/Clockworks Viewer Pro/Contents/MacOS/clockworks-mcp-bridge
In Claude, click Settings → Developer
Click edit config
Add this to your agent config below like so.
"clockworks": {
"command": "/Applications/Clockworks Viewer Pro/Contents/MacOS/clockworks-mcp-bridge"
},
<aside> 🔌
The bridge you configured (clockworks-mcp-bridge) connects to your running copy of Viewer Pro and exposes its cue and setlist data to your agent as MCP tools. Viewer Pro must be open on the same machine, with the MCP service enabled, for the tools to respond.
</aside>
Every project loaded in Viewer Pro has one setlist (the ordered list of tracks) and, for each track, a cuelist (the ordered cues on that track). The agent always works against whatever project is currently open — there is no separate open or save step. Tracks are addressed by title, exactly as shown on the deck, and individual cues by a numeric cue_id that you get from list_cues.