Use Hero from Claude, ChatGPT, and other AI tools
Updated October 29, 2026
Hero MCP is Hero's remote MCP server. Connect it to Claude, ChatGPT, or any MCP client, and your assistant can find projects, start generations, export PDFs, and adjust shooting schedules in Hero, with your own permissions.
https://api.herovideo.ai/mcp- Works with
- Claude
- ChatGPT
- Grok
- Gemini CLI
- Any MCP client
What is Hero MCP?
MCP (Model Context Protocol) is an open standard that lets AI assistants connect to the apps you use. Hero MCP is Hero's MCP server. Add it to your AI assistant once, sign in with your Hero account, and the assistant can read and update your video projects in Hero, the pre-production platform by Lemonlight.
It works with Claude (on the web, in the desktop app, and in Claude Code) as a custom connector, and with other AI tools that support remote MCP servers with sign-in.
Server URL: https://api.herovideo.ai/mcp
Set up Hero MCP
You'll need a Hero account. If you don't have one, create one free. Then add Hero to your AI tool.
Claude (web or desktop)
- In Claude, open Settings → Connectors → Add custom connector.
- Name it Hero and paste the server URL:
https://api.herovideo.ai/mcp - Click Connect and sign in with your Hero account.
- Approve read access, or read and write access if you want Claude to make changes.
- In a chat, turn on the Hero connector and ask, for example, "list my Hero projects".
Claude Code
Run this command, then run /mcp and sign in with your Hero account.
claude mcp add --transport http hero https://api.herovideo.ai/mcpChatGPT
- In ChatGPT, open Settings → Apps and turn on developer mode under Advanced settings.
- Create an app, name it Hero, and paste the server URL.
- Sign in with your Hero account when asked.
Developer mode may need a paid ChatGPT plan, or a workspace admin to turn it on.
Grok
- Go to grok.com/connectors.
- Click New Connector, choose Custom, and paste the server URL.
- Sign in with your Hero account when asked.
Gemini CLI
Add Hero with this command, then run /mcp auth hero in Gemini CLI and sign in with your Hero account.
gemini mcp add --transport http hero https://api.herovideo.ai/mcpOther AI tools
Add a remote MCP server with the URL https://api.herovideo.ai/mcp and sign in with your Hero account when prompted. Hero works with any AI tool that supports remote MCP servers with sign-in.
What your assistant can read
- Projects, found by name or Project ID
- Concepts, scripts, and custom documents
- Storyboards and their frames
- Characters, sets, and props
- The shooting schedule and call sheets
- Text from uploaded assets
- Deliverable status and comments
What your assistant can do
- Create a project, or duplicate one
- Start a concept, script, or storyboard generation and track its progress
- Export PDFs
- Create documents, and keep a running document updated section by section
- Add assets, and create or rename characters, sets, and props
- Rename projects and files, and set their status, notes, and privacy
- Invite or remove project members
- Adjust the shooting schedule: reorder strips, shift times, set a day's call time, move a production day, edit strip fields, and lock strip times
Example prompts
Hero MCP comes with built-in starters for common jobs:
- Review a concept
- Create a shoot from a concept
- Do an interiors-first schedule pass
- Sync a project's status
Or ask in your own words:
- "List my Hero projects."
- "Export the storyboard for Summer launch as a PDF."
- "Start day 2 at 7 AM and lock the interview strip at 4 PM."
Permissions and safety
- You sign in with your own Hero account, and your assistant only sees the organizations and projects you can already open.
- You choose read-only or read-and-write access when you connect.
- Changes that overwrite something or affect other people ask you to confirm before they happen.
What's not supported yet
- Editing concept or script text
- Generating or editing images
- Creating call sheets
- Replying to comments
Inside Hero, Hero Agent can already rewrite concepts and scripts and edit storyboard images by chat.
Frequently asked questions
What is the Hero MCP server URL?
The server URL is https://api.herovideo.ai/mcp. Add it to your AI tool as a remote MCP server or custom connector, then sign in with your Hero account.
Which AI tools work with Hero MCP?
Claude on the web, in the desktop app, and in Claude Code, plus other AI tools that support remote MCP servers with sign-in, such as ChatGPT (in developer mode), Grok, and Gemini CLI.
Do I need a Hero account?
Yes. You sign in with your Hero account when you connect. If you don't have one, you can create one free.
Can my assistant see all of my projects?
No. It only sees the organizations and projects you can already open in Hero.
Can my assistant change my projects?
Only if you give it read-and-write access. Changes that overwrite something or affect other people ask you to confirm first.
What can't Hero MCP do yet?
It can't edit concept or script text, generate or edit images, create call sheets, or reply to comments yet.
What are we making?
Start with an idea, a scene, or a story. We'll help you take it from there.