# Generate videos from Claude Code

> Add the Motionvid MCP server to Claude Code with one command, or install the Motionvid skill, and generate motion graphics videos from your terminal.

One command registers the server, one signs you in. Add the skill and Claude Code knows how to brief, check, preview and download a video on its own.

## Set it up

`shell`

```
claude mcp add --transport http motionvid https://motionvid.ai/mcp
```

1. Run: claude mcp add --transport http motionvid https://motionvid.ai/mcp
2. Sign in: claude mcp login motionvid, or /mcp → Authenticate inside a session.
3. Ask Claude Code for a video.

Headless: append --header "Authorization: Bearer mvk_your_api_key" to the command instead of signing in.

## Example prompts

- "Read our README and make a 30 second launch video for this repo, then save the MP4 to ./media."
- "Make a 30 second explainer on how compound interest works, with voiceover and music."
- "Turn https://yourapp.com into a 20 second vertical launch ad that ends on our logo."
- "Make a 15 second animated bar chart of these numbers: 2023 1.2M, 2024 2.9M, 2025 6.4M."

## Tips

- Install the skill (npx skills add tolypash/motionvid-agent) so Claude Code follows the same steps every time.
- Headless or CI: append --header "Authorization: Bearer mvk_your_api_key" to the add command instead of signing in.
- Ask Claude Code to download the MP4 into the repo once the render finishes.

## Questions and troubleshooting

### Can Claude Code make videos?

Yes, with the Motionvid MCP server it can generate finished videos from a prompt or from your repo’s docs, preview them and download the MP4, with no rendering setup on your machine.

### Do I need Remotion or FFmpeg?

No. Motionvid renders in the cloud and returns an MP4. Nothing is installed locally besides the MCP entry.

### It says I need to sign in, or the tools are missing

The server is added but not signed in. Run the sign-in step again and log in with your Motionvid account. The connector needs a paid plan; on a free account the tools answer with an upgrade message.

### The video is taking a while

That's normal. A build writes the script, animates each scene and records the voiceover, usually a few minutes. Ask the agent to check the status again rather than starting a new video.

## More

- All agents: https://motionvid.ai/agents.md
- Skill: https://motionvid.ai/SKILL.md