MCP · setup guide
Connect Macro Studio to Claude
Macro Studio has an MCP server built in, called macro-studio. Connect it once and Claude can cut, caption, restyle and export the take you have open, while you watch the edits land in the editor. It runs on your Mac, inside the app.
1 Before you start
- Have a Macro Studio account: sign in to the studio and upload a video, or record on the Mac app with Settings › Cloud › Cloud sync on.
- That’s it. The connector works from claude.ai, the Claude app, your phone or Claude Code, with no app open.
2 Connect
Claude (the Claude app or claude.ai)
recommendedAdd to the Claude app Add on claude.ai
Claude app: it opens on Connectors with the URL copied. Click Add › Custom connector, paste, then Connect and sign in. claude.ai: the dialog is filled in; press Continue, then Connect. Connectors follow your Claude account, so adding it in one shows it in both. The URL:
- URL
https://www.trymacrostudio.com/cloud/mcp
Claude Code
Run this, then type /mcp in Claude Code, pick macro-studio and sign in:
claude mcp add --transport http macro-studio https://www.trymacrostudio.com/cloud/mcp
The Mac app’s own server
no accountWith Macro Studio open on your Mac, Claude Code can also use the app directly (recording included, no sign-in). Click Connect Claude in the editor, or run:
claude mcp add --transport http macro-studio http://127.0.0.1:43130/mcp
Inside the editor
No setup at all: Edit by asking in the Macro Studio editor takes the same requests and drives the same tools.
Any other MCP client
Cursor, VS Code, Windsurf…Add an HTTP (streamable) MCP server with this URL:
- Name
macro-studio- URL
http://127.0.0.1:43130/mcp
Most clients take it as JSON:
{
"mcpServers": {
"macro-studio": {
"type": "http",
"url": "http://127.0.0.1:43130/mcp"
}
}
}3 Check it works
With Macro Studio open, ask Claude:
Claude calls list_takes and lists your recordings. If it can’t connect, see troubleshooting.
4 Use it
Talk to Claude normally. You don’t need to name tools.
Removes filler words and shortens long pauses, keeping moments where something happens on screen.
Finds lines you said more than once and keeps the last attempt.
Moves where the video starts and ends.
Picks the moments worth posting, cuts each one and adds captions.
Restyles the webcam: shape, size, corner, zoom.
Adds a zoom timed to the words, so it moves with later cuts.
Writes an .srt timed to the edited video beside the take.
Renders an MP4 to ~/Movies/Macro Studio.
Every edit shows up live in the Macro Studio editor and is its own undo step. Claude’s undo and yours are kept apart, so ⌘Z only takes back what you did. Your original recording is never changed.
A typical session
- Record a long take in Macro Studio and open it.
- You: “Tidy it up.” Claude cuts fillers, pauses and retakes, then tells you the new length.
- You: “Now cut seven shorts from it, captions on, and export them vertical.”
Tools
The core tools Claude sees. More (stock b-roll, music, sound effects, Studio Sound, subtitles) are listed by list_tools.
| Tool | What it does |
|---|---|
list_takes | The takes in your library. |
open_take | Open a take, or import any .mp4/.mov, into the editor. |
get_transcript | Every word of the take with its index and time. Cuts are by word. |
get_editor_state | What the edit looks like now: length, cuts, layout, captions. |
cut_ranges | Cut words (by index) or time ranges. |
restore_ranges | Bring cut words back. |
trim | Set where the video starts and ends. |
cut_fillers | Cut every um, uh and similar filler. |
tighten_pauses | Shorten every pause over 0.4 s to 0.15 s (adjustable). |
remove_retakes | Keep only the last attempt at a line you said more than once. |
fix_words | Correct a misheard word in the transcript and captions. |
add_motion | Zooms and animated text, timed to words. |
add_title | A title over the video. |
add_graphic | A motion graphic: a template or your own Remotion component. |
set_layout | Camera shape, size and position; the backdrop look. |
set_captions | Burned-in captions in one of six styles. |
get_frame | A still of the edited video at any moment, so Claude can check the picture. |
get_frames | Several stills at once. |
check_edit | Lint the edit for problems and fix the mechanical ones. |
undo | Undo Claude’s last edit (your own undo is separate). |
redo | Redo it. |
export | Render an MP4: vertical, square or wide. |
list_tools | The extended tools: stock b-roll, music, Studio Sound, subtitles and more. |
Troubleshooting
- “Can’t connect”
- Open Macro Studio, then try again. The server only runs while the app is open. If port 43130 was busy when the app started, it picks a nearby one: Connect Claude in the editor always shows the current address.
- The tools don’t show up
- Restart Claude Code after adding the server. In Claude Code,
/mcplists connected servers;macro-studioshould say connected. - “Origin not allowed” (403) from a custom client
- Requests from web pages (with an
Originheader) are always refused, on purpose, so a website can’t drive your editor. - Is anything sent to the internet?
- Recording, transcription, editing and export stay on your Mac. What you say to Claude goes to your own Claude account, as usual.
- Can I use it from another computer, or my phone?
- Yes, with the connector (
https://www.trymacrostudio.com/cloud/mcp): it works anywhere you use Claude. The Mac app’s own server listens on127.0.0.1, so only apps on that Mac can reach it.