All agents

Hermes + invideo

Hermes Agent is Nous Research's open-source AI agent. It runs in your terminal and in the chat apps you already use, and it remembers what it learns across sessions. Connected to invideo, Hermes makes your videos on a timeline in invideo Editor and sends the link back to the terminal or chat you asked from.

invideo CLIMCP ServerHermes MCP DocsHermes Agent Docs

Quick start

  1. 1

    Install Hermes Agent

    Run the installer on Linux, macOS or WSL2

    curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
  2. 2

    Install the invideo CLI

    Needs Node.js. To run it without installing, use npx invideo@latest

    npm install -g invideo
  3. 3

    Sign in to invideo

    Opens your browser. Approve it with your invideo account

    invideo auth login
  4. 4

    Make a video

    Ask from your terminal or any chat Hermes is in. It runs invideo commands and sends you the editor link

    Read https://github.com/invideoio/cli/blob/main/AGENTS.md, then use the invideo CLI to make a 30-second launch video with a voiceover and music
  5. 5

    Or add the MCP server

    Instead of the CLI, add invideo's MCP server and turn on all its tools, then run /reload-mcp

    hermes mcp add invideo --url https://mcp.invideo.io/mcp --auth oauth

MCP configuration

Connect Hermes to invideoSet up the remote MCP server for Hermes Agent. Sign in with your invideo account. No API key needed.

Example prompts

  • “Make a 45-second video from this script with a voiceover and stock b-roll”

  • “Add background music to my project”

  • “Cut my video down to 30 seconds”

  • “Upload our brand font and caption the voiceover from this script”

  • “Make a vertical version for Reels and Shorts”

  • “Check the timeline and fix any gaps”

  • “Mix the music under the voiceover”

  • “Turn this blog post into a 60-second video with stock footage”

  • “Make a product demo from the screen recordings in ~/Desktop/demo, with a voiceover and music”

  • “Export the final cut as a DaVinci Resolve project”

Common workflows

  1. 1Connect for the first time

    • Run hermes mcp add invideo --url https://mcp.invideo.io/mcp --auth oauth
    • Sign in with your invideo account in the browser it opens
    • Turn on all of invideo's tools when Hermes asks
    • Run /reload-mcp or start a new session

  2. 2Edit from a chat

    • Run hermes gateway setup once to connect your chat apps, then start it with hermes gateway
    • Message Hermes the video you want
    • Hermes starts a project in invideo Editor and sends you the link
    • Reply in the same chat to change anything

  3. 3Take over the edit

    • Ask Hermes for a first cut
    • Open the project link in your browser
    • Fix a cut by hand while Hermes keeps working
    • Ask Hermes for the next change

  4. 4Hand off to your NLE

    • Ask Hermes to export the project for Premiere Pro, Final Cut Pro or DaVinci Resolve
    • Hermes exports it with the media and downloads it for you
    • Open the project in your editor and keep cutting

Tips for success

  • Turn on all of invideo's tools when you add the server. Change them later with hermes mcp configure invideo
  • Run /reload-mcp after adding the server so the tools load without a restart
  • Keep the project open in your browser to watch each edit as it happens

Frequently asked questions

Should I use the invideo CLI or the MCP server?

Either works, on the same invideo timeline. With the CLI, Hermes runs invideo commands in your terminal, follows the rules in the CLI's AGENTS.md and saves exports and frames straight to disk. The MCP server gives Hermes invideo's tools inside its session, with nothing to install.

How do I give Hermes access to invideo?

Install the invideo CLI with npm install -g invideo and run invideo auth login. Or add the MCP server with hermes mcp add invideo --url https://mcp.invideo.io/mcp --auth oauth. It opens your browser to sign in with your invideo account, then asks which tools to turn on. Turn them all on, then run /reload-mcp or start a new session.

Can I ask for edits from a chat app?

Yes. Add invideo and sign in from the terminal first. Hermes' messaging gateway uses the same config, so invideo's tools are there in every chat Hermes is connected to.

Do I need an invideo account?

Yes. You sign in with an invideo account when you connect, and you can create one during sign-in.

Troubleshooting

Issue:Hermes can't find invideo's tools

Solution:A session's tools are fixed when it starts. Run /reload-mcp or start a new session. Check the server is listed with hermes mcp list.

Issue:Some invideo tools are missing

Solution:Run hermes mcp configure invideo, turn all of its tools on, then run /reload-mcp.

Issue:invideo stops responding or asks you to sign in

Solution:Run hermes mcp test invideo to check the connection, then hermes mcp login invideo to sign in to invideo again.

Ready to make videos with Hermes?

Connect invideo once and ask for your first cut.