# How to integrate Magic Hour MCP with Hermes

```json
{
  "title": "How to integrate Magic Hour MCP with Hermes",
  "toolkit": "Magic Hour",
  "toolkit_slug": "magic_hour",
  "framework": "Hermes",
  "framework_slug": "hermes-agent",
  "url": "https://composio.dev/toolkits/magic_hour/framework/hermes-agent",
  "markdown_url": "https://composio.dev/toolkits/magic_hour/framework/hermes-agent.md",
  "updated_at": "2026-09-10T05:31:24.008Z"
}
```

## Introduction

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.
This guide explains the easiest and most robust way to connect your Magic Hour account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

## Also integrate Magic Hour with

- [ChatGPT Work](https://composio.dev/toolkits/magic_hour/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/magic_hour/framework/claude-cowork)

## TL;DR

### What is Composio Connect?
Composio Connect is a consumer offering that lets anyone plug 1,500+ applications directly into their agent harness — including Hermes. It can:
- Search and load tools from relevant toolkits on-demand, reducing context usage.
- Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
- Manage app authentication end-to-end with zero manual overhead.

## Connect Magic Hour to Hermes

### Integrating Magic Hour with Hermes
### Using Composio Connect CLI
1. Install the Composio CLI
Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

```bash
curl -fsSL https://composio.dev/install | bash
```

## What is the Magic Hour MCP server, and what's possible with it?

The Magic Hour MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Magic Hour account. It provides structured and secure access so your agent can perform Magic Hour operations on your behalf.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `MAGIC_HOUR_CREATE_AI_CLOTHES_CHANGE` | Create AI Clothes Change | Start a credit-consuming asynchronous clothes-change image job from person and garment images. Each image costs 25 credits. The operation is documented for Free accounts but requires sufficient credits. It returns an image project ID immediately, not a completed image; poll MAGIC_HOUR_GET_IMAGE_PROJECT until status is complete or error. |
| `MAGIC_HOUR_CREATE_AI_FACE_EDIT` | Create AI Face Edit | Start a credit-consuming asynchronous edit of facial features in an image. This Free-tier operation returns an image project ID and credit charge immediately, not a completed image. Pass the ID to MAGIC_HOUR_GET_IMAGE_PROJECT and poll until status is complete or error. |
| `MAGIC_HOUR_CREATE_AI_GIF` | Create AI GIF | Start a credit-consuming asynchronous prompt-based animation in GIF, MP4, or WebM format. This operation costs 50 credits and returns an image project ID immediately, not completed media. Pass the ID to MAGIC_HOUR_GET_IMAGE_PROJECT and poll until status is complete, error, or canceled. |
| `MAGIC_HOUR_CREATE_AI_HEADSHOT` | Create AI Headshot | Start a credit-consuming asynchronous headshot generation from an image containing one detectable face. Each headshot costs 50 credits. This returns an image project ID immediately, not a completed image; poll MAGIC_HOUR_GET_IMAGE_PROJECT until status is complete, error, or canceled. |
| `MAGIC_HOUR_CREATE_AI_IMAGE` | Create AI Image | Start a credit-consuming asynchronous text-to-image job. The request returns a project ID and immediate credit charge, not completed images. Model, image-count, resolution, cost, and tier availability vary by option; only flux-2-klein, flux-schnell, and z-image-turbo are documented for Free. Pass the returned ID to MAGIC_HOUR_GET_IMAGE_PROJECT and poll until status is complete or error. |
| `MAGIC_HOUR_CREATE_AI_IMAGE_EDIT` | Create AI Image Edit | Start a credit-consuming asynchronous prompt-based edit of one or more images. Model, resolution, input-image limits, cost, and tier availability vary by option. Credits are charged when the request is made. Pass the returned project ID to MAGIC_HOUR_GET_IMAGE_PROJECT and poll until status is complete or error. |
| `MAGIC_HOUR_CREATE_AI_MEME` | Create AI Meme | Start a credit-consuming asynchronous meme generation from a topic and a documented Magic Hour template. Each meme costs 10 credits. This returns an image project ID immediately, not a completed image; pass the ID to MAGIC_HOUR_GET_IMAGE_PROJECT and poll until status is complete or error. |
| `MAGIC_HOUR_CREATE_AI_QR_CODE` | Create AI QR Code | Start an asynchronous artistic QR-code generation for supplied content. Magic Hour documents each AI QR code as costing 0 credits. The operation returns an image project ID and credits charged immediately, not a completed image; poll MAGIC_HOUR_GET_IMAGE_PROJECT until status is complete or error. |
| `MAGIC_HOUR_CREATE_AI_VIDEO_EDIT` | Create AI Video Edit | Start a credit-consuming asynchronous prompt-based edit of an input video. Free accounts default to the ltx-2.3 model and 480p; other model and resolution options depend on the connected account's plan. The returned credit charge is initially an estimate. Pass the returned project ID to MAGIC_HOUR_GET_VIDEO_PROJECT and poll until status is complete, error, or canceled. |
| `MAGIC_HOUR_CREATE_AI_VOICE` | Create AI Voice | Start credit-consuming asynchronous speech generation from text using a documented preset voice. Each character costs 0.1 credits, rounded up to a whole credit. This returns an audio project ID and immediate credit charge, not completed audio; pass the ID to MAGIC_HOUR_GET_AUDIO_PROJECT and poll until status is complete or error. |
| `MAGIC_HOUR_CREATE_AI_VOICE_CLONE` | Create AI Voice Clone | Start credit-consuming asynchronous speech generation by cloning an input voice recording. Each prompt character costs 0.1 credits, rounded up to a whole credit, and sufficient credits are required. This returns an audio project ID and immediate credit charge, not completed audio; pass the ID to MAGIC_HOUR_GET_AUDIO_PROJECT and poll until status is complete or error. |
| `MAGIC_HOUR_CREATE_ANIMATION_VIDEO` | Create Animation Video | Start one credit-consuming asynchronous animation render with explicit dimensions, frame rate, duration, style, and assets. The request returns immediately with a video project ID and estimated credits charged; pass the ID to MAGIC_HOUR_GET_VIDEO_PROJECT and poll until complete, error, or canceled. |
| `MAGIC_HOUR_CREATE_AUDIO_TO_VIDEO` | Create Audio-to-Video | Start a credit-consuming asynchronous video generation job from audio and optional visual style controls. Free accounts can use the documented 480p default; higher resolutions depend on the connected account's plan. Returns a video project ID immediately; poll MAGIC_HOUR_GET_VIDEO_PROJECT until the project is complete, error, or canceled. Requires sufficient credits, and the initial credits_charged value is an estimate until rendering finishes. |
| `MAGIC_HOUR_CREATE_BACKGROUND_REMOVAL` | Create Background Removal | Start a credit-consuming asynchronous image job that removes a background or replaces it with an optional supplied image. Each image costs 5 credits. The operation is documented for Free accounts but requires sufficient credits. It returns an image project ID immediately, not a completed image; poll MAGIC_HOUR_GET_IMAGE_PROJECT until status is complete or error. |
| `MAGIC_HOUR_CREATE_BODY_SWAP` | Create Body Swap | Start a credit-consuming asynchronous body-swap image job that places a person into a scene at the selected resolution. Resolution determines the model and credit cost. This returns an image project ID immediately, not a completed image; pass the ID to MAGIC_HOUR_GET_IMAGE_PROJECT and poll until status is complete or error. Credits are charged when this request is made and refunded if generation fails. |
| `MAGIC_HOUR_CREATE_CHARACTER_ANIMATION_VIDEO` | Create Character Animation Video | Animate a reference character with motion transferred from a source video in a credit-consuming asynchronous job. The documented 480p default is available on Free; 720p depends on the connected account's plan. This returns a project ID and estimated credit charge, not a completed video. Poll MAGIC_HOUR_GET_VIDEO_PROJECT with the returned ID until status is complete, error, or canceled. |
| `MAGIC_HOUR_CREATE_CHARACTER_REPLACEMENT_VIDEO` | Create Character Replacement Video | Replace a source-video subject with a reference character in a credit-consuming asynchronous video job. The documented 480p default is available on Free; 720p depends on the connected account's plan. This returns a project ID and estimated credit charge, not a completed video. Poll MAGIC_HOUR_GET_VIDEO_PROJECT with the returned ID until status is complete, error, or canceled. |
| `MAGIC_HOUR_CREATE_FACE_SWAP_PHOTO` | Create Face Swap Photo | Start a credit-consuming asynchronous photo face swap using one source face for all detected faces or up to five individual face mappings. Each photo costs 10 credits. The operation returns an image project ID and credit charge immediately, not a completed image; poll MAGIC_HOUR_GET_IMAGE_PROJECT until status is complete or error. |
| `MAGIC_HOUR_CREATE_FACE_SWAP_VIDEO` | Create Face Swap Video | Start a credit-consuming asynchronous video face-swap job using one image for all detected faces or up to five individual face mappings. The operation is documented for Free accounts but requires sufficient credits. It returns a project ID and estimated charge immediately, not a completed video; poll MAGIC_HOUR_GET_VIDEO_PROJECT until status is complete, error, or canceled. |
| `MAGIC_HOUR_CREATE_HEAD_SWAP` | Create Head Swap | Start a credit-consuming asynchronous head-swap image job from body and head images. Each image costs 10 credits. This returns an image project ID immediately, not a completed image; pass the ID to MAGIC_HOUR_GET_IMAGE_PROJECT and poll until status is complete or error. Credits are charged when this request is made and refunded if generation fails. |
| `MAGIC_HOUR_CREATE_IMAGE_TO_VIDEO` | Create Image-to-Video | Start a credit-consuming asynchronous video generation job from a still image and optional final frame, prompt, audio, model, and resolution controls. Free accounts default to ltx-2.5 at 480p; other model and resolution options depend on the connected account's plan. Returns a project ID and estimated credit charge immediately; poll MAGIC_HOUR_GET_VIDEO_PROJECT until status is complete, error, or canceled. |
| `MAGIC_HOUR_CREATE_IMAGE_UPSCALE` | Create Image Upscale | Start a credit-consuming asynchronous 2x or 4x image upscale. A 4x upscale requires a Creator, Pro, or Business tier, while mode affects the credit charge. This returns an image project ID immediately, not a completed image; poll MAGIC_HOUR_GET_IMAGE_PROJECT until status is complete or error. |
| `MAGIC_HOUR_CREATE_LIP_SYNC_VIDEO` | Create Lip Sync Video | Start a credit-consuming asynchronous lip-sync video job from audio and a file or YouTube video. This returns a project ID immediately, not the completed video; poll MAGIC_HOUR_GET_VIDEO_PROJECT until complete, error, or canceled. The returned credit charge is an estimate, may be adjusted after rendering based on actual output FPS, and is refunded if generation fails. |
| `MAGIC_HOUR_CREATE_PHOTO_COLORIZATION` | Create Photo Colorization | Start a credit-consuming asynchronous colorization of a photo. Each image costs 10 credits. This returns an image project ID immediately, not a completed image; poll MAGIC_HOUR_GET_IMAGE_PROJECT until status is complete or error. |
| `MAGIC_HOUR_CREATE_SUBTITLED_VIDEO` | Create Subtitled Video | Start a credit-consuming asynchronous job that transcribes speech and burns styled subtitles into an MP4 video. This returns a project ID immediately, not the completed video; poll MAGIC_HOUR_GET_VIDEO_PROJECT until complete, error, or canceled. The initial credit charge is an estimate, can be adjusted after rendering, and is refunded if generation fails. |
| `MAGIC_HOUR_CREATE_TALKING_PHOTO` | Create Talking Photo | Start a credit-consuming asynchronous talking-photo video from an image and audio. This operation is documented for Free accounts, but requires enough credits and available models and resolutions depend on the connected account's tier. It returns immediately with a video project ID; pass that ID to MAGIC_HOUR_GET_VIDEO_PROJECT and poll until complete, error, or canceled. |
| `MAGIC_HOUR_CREATE_TEXT_TO_VIDEO` | Create Text-to-Video | Start a credit-consuming asynchronous video generation job from a text prompt and model/output options. Free accounts default to ltx-2.5 at 480p; model, duration, aspect ratio, resolution, and audio availability vary by plan. This returns a project ID and estimated credit charge, not a completed video; poll MAGIC_HOUR_GET_VIDEO_PROJECT until status is complete, error, or canceled. |
| `MAGIC_HOUR_CREATE_VIDEO_TO_VIDEO` | Create Video-to-Video | Start a credit-consuming asynchronous stylized transformation of an input video. Free accounts can use the documented lower-resolution configuration; higher output quality depends on the connected account's plan. Returns a project ID and estimated credit charge immediately, not a completed video. Poll MAGIC_HOUR_GET_VIDEO_PROJECT with the returned ID until status is complete, error, or canceled. |
| `MAGIC_HOUR_DELETE_AUDIO_PROJECT` | Delete Audio Project | Permanently delete one rendered Magic Hour audio project by ID. This destructive operation is irreversible and is not a way to cancel a queued or rendering audio project. Success requires exactly HTTP 204 with an empty body. |
| `MAGIC_HOUR_DELETE_IMAGE_PROJECT` | Delete Image Project | Permanently delete one Magic Hour image project and its rendered images by ID. This destructive operation is irreversible and is not a way to cancel a render. Success requires exactly HTTP 204 with an empty body. |
| `MAGIC_HOUR_DELETE_VIDEO_PROJECT` | Delete Video Project | Permanently delete one rendered Magic Hour video project by ID. This destructive operation is irreversible and is not a way to cancel a queued or rendering video. Success requires exactly HTTP 204 with an empty body. |
| `MAGIC_HOUR_DETECT_FACES` | Detect Faces | Start asynchronous face detection for an image or video and return a task ID. Pass the returned ID to MAGIC_HOUR_GET_FACE_DETECTION and poll until status is complete or error. Face detection is currently documented as free, though pricing may change. |
| `MAGIC_HOUR_GENERATE_ASSET_UPLOAD_URLS` | Generate Asset Upload URLs | Generate ordered, expiring signed upload URLs and Magic Hour file paths for image, video, or audio assets. This allocates upload URLs but does not upload file bytes. Treat each signed URL query string as sensitive: do not log or persist it. |
| `MAGIC_HOUR_GET_ACCOUNT` | Get Account | Return the connected Magic Hour account's tier, available credits, identity, and subscription details; use this before generation to check entitlement and balance. |
| `MAGIC_HOUR_GET_AUDIO_PROJECT` | Get Audio Project | Get an audio project's asynchronous status, error, credit charge, and temporary downloads. Poll until complete, error, or canceled. Download URLs expire at their expires_at timestamps; call this tool again afterward to obtain refreshed URLs. |
| `MAGIC_HOUR_GET_FACE_DETECTION` | Get Face Detection | Get face-detection status and detected face paths by task ID. Poll only IDs returned by MAGIC_HOUR_DETECT_FACES and stop on complete or error: live probing showed that arbitrary and malformed IDs can return 200 queued indefinitely, so a successful response does not prove the task exists. |
| `MAGIC_HOUR_GET_IMAGE_PROJECT` | Get Image Project | Get an image project's asynchronous status, error, credit charge, and temporary downloads. Poll until complete, error, or canceled. Download URLs expire at their expires_at timestamps; call this tool again afterward to obtain refreshed URLs. |
| `MAGIC_HOUR_GET_VIDEO_PROJECT` | Get Video Project | Get a video project's asynchronous status, error, credit charge, and temporary downloads. Poll until complete, error, or canceled. Download URLs expire after 24 hours; call this tool again to refresh expired URLs. |

## Supported Triggers

None listed.

## Creating MCP Server - Stand-alone vs Composio SDK

The Magic Hour MCP server provides comprehensive access to Magic Hour operations through Composio. Once connected, Hermes can perform all major Magic Hour actions on your behalf using natural language commands.

## Complete Code

None listed.

## Conclusion

### Way Forward
With Magic Hour connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.
From here, you can extend Hermes further:
- Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
- Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
- Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.
If you run into trouble or want to share what you've built, join the [community](https://discord.com/invite/composio) or check out the [Docs](https://docs.composio.dev?utm_source=toolkits&utm_medium=framework_template&utm_campaign=hermes&utm_content=docs) for deeper configuration options.

## How to build Magic Hour MCP Agent with another framework

- [ChatGPT Work](https://composio.dev/toolkits/magic_hour/framework/chatgpt)
- [Claude Cowork](https://composio.dev/toolkits/magic_hour/framework/claude-cowork)

## Related Toolkits

- [Figma](https://composio.dev/toolkits/figma) - Figma is a collaborative interface design tool for teams and individuals. It streamlines design workflows with real-time collaboration and easy sharing.
- [Abyssale](https://composio.dev/toolkits/abyssale) - Abyssale is a creative automation platform for generating images, videos, GIFs, PDFs, and HTML5 content programmatically. It streamlines and scales visual content production for marketing, design, and operations teams.
- [Alttext ai](https://composio.dev/toolkits/alttext_ai) - AltText.ai is a service that generates alt text for images automatically. It helps boost accessibility and SEO for your visual content.
- [Are.na](https://composio.dev/toolkits/arena) - Are.na is a creative research platform for collecting images, links, notes, and ideas in channels. Use it to organize inspiration, build knowledge maps, and connect research across projects.
- [Bannerbear](https://composio.dev/toolkits/bannerbear) - Bannerbear is an API-driven platform for generating images and videos automatically at scale. It helps businesses create custom graphics, social visuals, and marketing assets using powerful templates.
- [Bannerbite](https://composio.dev/toolkits/bannerbite) - Bannerbite is a creative automation platform for generating images and videos from reusable projects and templates. It helps teams produce on-brand visual assets faster without rebuilding designs from scratch.
- [Builder.io](https://composio.dev/toolkits/builder_io) - Builder.io is a visual development platform for managing content, models, assets, and Space configuration. Use it to ship editable digital experiences faster without waiting on every code change.
- [Canva](https://composio.dev/toolkits/canva) - Canva is a drag-and-drop design suite for creating professional graphics, presentations, and marketing materials. It makes it easy for anyone to design with beautiful templates and a vast library of elements.
- [Canva MCP](https://composio.dev/toolkits/canva_mcp) - Canva MCP is Canva's remote MCP server for accessing designs and content. It centralizes design assets and enables programmatic design workflows.
- [Claid ai](https://composio.dev/toolkits/claid_ai) - Claid.ai delivers AI-driven image editing APIs for tasks like background removal, upscaling, and color correction. It helps automate and enhance image workflows with powerful, developer-friendly tools.
- [Cloudinary](https://composio.dev/toolkits/cloudinary) - Cloudinary is a cloud-based platform for managing, uploading, and transforming images and videos. It streamlines media workflows and delivers optimized assets globally.
- [Contentdrips](https://composio.dev/toolkits/contentdrips) - Contentdrips is an asynchronous rendering API for branded graphics and carousels. It turns reusable templates into on-brand social visuals at scale.
- [Creatomate](https://composio.dev/toolkits/creatomate) - Creatomate is an API for generating automated videos, images, GIFs, and reusable media templates. Use it to turn structured data into polished visual content at scale.
- [Cults](https://composio.dev/toolkits/cults) - Cults is a digital marketplace for 3D printing models, connecting designers and makers. It lets creators share, sell, and discover a huge variety of printable designs easily.
- [DeepImage](https://composio.dev/toolkits/deepimage) - DeepImage is an AI-powered image enhancer and upscaler. Get higher-quality images with just a few clicks.
- [Dreamstudio](https://composio.dev/toolkits/dreamstudio) - DreamStudio is Stability AI’s platform for generating and editing images with AI. It lets you easily turn ideas into stunning visuals, fast.
- [Dynamic Mockups](https://composio.dev/toolkits/dynamic_mockups) - Dynamic Mockups is an API platform for generating product mockups, rendering templates, and managing visual asset catalogs. Use it to automate high-quality product visuals, AI images, and motion assets at scale.
- [Dynapictures](https://composio.dev/toolkits/dynapictures) - Dynapictures is a cloud-based platform for generating personalized images at scale. Instantly create hundreds of custom visuals using your data sources, like Google Sheets.
- [Eraser MCP](https://composio.dev/toolkits/eraser_mcp) - Eraser MCP is a workspace for creating and managing technical diagrams and structured documents. It helps teams organize, version, and export diagrams with collaboration-focused tooling.
- [Excalidraw MCP](https://composio.dev/toolkits/excalidraw_mcp) - Excalidraw MCP is a no-auth MCP server for creating hand-drawn style diagrams in Excalidraw. Use it to generate visual sketches with viewport camera control and fullscreen editing.

## Frequently Asked Questions

### What are the differences in Tool Router MCP and Magic Hour MCP?

With a standalone Magic Hour MCP server, the agents and LLMs can only access a fixed set of Magic Hour tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Magic Hour and many other apps based on the task at hand, all through a single MCP endpoint.

### Can I use Tool Router MCP with Hermes?

Yes, you can. Hermes fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Magic Hour tools.

### Can I manage the permissions and scopes for Magic Hour while using Tool Router?

Yes, absolutely. You can configure which Magic Hour scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

### How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Magic Hour data and credentials are handled as safely as possible.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)