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

  1. 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.
  2. 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)

recommended

Add 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 account

With 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:

“What takes do I have in Macro Studio?”

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.

“Cut the ums and tighten the pauses”

Removes filler words and shortens long pauses, keeping moments where something happens on screen.

“Cut the false starts and keep the best take of each line”

Finds lines you said more than once and keeps the last attempt.

“Trim the start and the “ok, stop” at the end”

Moves where the video starts and ends.

“Cut this into seven shorts, one a day. Captions on.”

Picks the moments worth posting, cuts each one and adds captions.

“Put my camera bottom-left as a circle”

Restyles the webcam: shape, size, corner, zoom.

“Zoom in when I open the settings”

Adds a zoom timed to the words, so it moves with later cuts.

“Save the subtitles”

Writes an .srt timed to the edited video beside the take.

“Export it vertical”

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

  1. Record a long take in Macro Studio and open it.
  2. You: “Tidy it up.” Claude cuts fillers, pauses and retakes, then tells you the new length.
  3. 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.

ToolWhat it does
list_takesThe takes in your library.
open_takeOpen a take, or import any .mp4/.mov, into the editor.
get_transcriptEvery word of the take with its index and time. Cuts are by word.
get_editor_stateWhat the edit looks like now: length, cuts, layout, captions.
cut_rangesCut words (by index) or time ranges.
restore_rangesBring cut words back.
trimSet where the video starts and ends.
cut_fillersCut every um, uh and similar filler.
tighten_pausesShorten every pause over 0.4 s to 0.15 s (adjustable).
remove_retakesKeep only the last attempt at a line you said more than once.
fix_wordsCorrect a misheard word in the transcript and captions.
add_motionZooms and animated text, timed to words.
add_titleA title over the video.
add_graphicA motion graphic: a template or your own Remotion component.
set_layoutCamera shape, size and position; the backdrop look.
set_captionsBurned-in captions in one of six styles.
get_frameA still of the edited video at any moment, so Claude can check the picture.
get_framesSeveral stills at once.
check_editLint the edit for problems and fix the mechanical ones.
undoUndo Claude’s last edit (your own undo is separate).
redoRedo it.
exportRender an MP4: vertical, square or wide.
list_toolsThe 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, /mcp lists connected servers; macro-studio should say connected.
“Origin not allowed” (403) from a custom client
Requests from web pages (with an Origin header) 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 on 127.0.0.1, so only apps on that Mac can reach it.