Before you start
A video file without an audio track, such as sample-video-no-audio.mp4.
The audio you want to attach, such as sample-audio.m4a.
Step-by-step workflow
Describe the task in one prompt
Tell Claude which audio file and silent video to use, and ask it to upload both files with curl before calling Medux.
Using Medux, add sample-audio.m4a to
sample-video-no-audio.mp4.
Upload both files with the curl command.
Let Claude request upload URLs
Claude uses the Medux integration to create upload slots for the audio and video. Each slot returns a file ID and a temporary signed upload URL.
Keep the returned file IDs. Medux uses them in the merge request.
Upload the audio and video with curl
Run the generated commands in your local terminal. Use the correct content type for each file. The long signed URL is represented below by a placeholder so the command stays readable.
curl -X PUT -H "Content-Type: audio/mp4" --data-binary @./sample-audio.m4a "<SIGNED_AUDIO_UPLOAD_URL>"
curl -X PUT -H "Content-Type: video/mp4" --data-binary @./sample-video-no-audio.mp4 "<SIGNED_VIDEO_UPLOAD_URL>"200 with an empty response body.
Call the Medux audio-to-video tool
After both uploads succeed, Claude calls medux_add_audio_to_video with the audio file ID and video file ID. Medux creates a new processing task.
Tool: medux_add_audio_to_video
Inputs:
audio_file_id: <AUDIO_FILE_ID>
video_file_id: <VIDEO_FILE_ID>
Poll the task and download the result
Claude checks the Medux task until it is complete. When the result URL is ready, it downloads the finished video into the project folder.
Tool: medux_task_query
Input:
task_id: <TASK_ID>
curl -L "<RESULT_DOWNLOAD_URL>" -o ./sample-video-with-audio.mp4

Workflow at a glance
Why this workflow is useful
Claude handles the orchestration while Medux handles the media processing. You stay in one conversational workflow instead of building a custom upload interface, writing a separate API client, or switching between multiple dashboards.
Claude plans. MCP connects. Medux processes.
Explore related workflows
Continue with a nearby Medux workflow or compare how the same task works across Claude MCP and Codex MCP.
