# How to connect Magic Hour to Claude

```json
{
  "title": "How to connect Magic Hour to Claude",
  "toolkit": "Magic Hour",
  "toolkit_slug": "magic_hour",
  "framework": "Claude Cowork",
  "framework_slug": "claude-cowork",
  "url": "https://composio.dev/toolkits/magic_hour/framework/claude-cowork",
  "markdown_url": "https://composio.dev/toolkits/magic_hour/framework/claude-cowork.md",
  "updated_at": "2026-09-10T05:31:24.008Z"
}
```

## Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.
This guide walks you through the easiest and most secure way to connect your Magic Hour account to Claude via Composio Connect, enabling it to generate three 16:9 hero image variations, create 30-second promo video from script, transcribe and denoise a podcast episode, and more such actions on your behalf without compromising your account security.
Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

## Also integrate Magic Hour with

- [ChatGPT Work](https://composio.dev/toolkits/magic_hour/framework/chatgpt)
- [Hermes](https://composio.dev/toolkits/magic_hour/framework/hermes-agent)

## Connect Magic Hour to Claude Cowork

### Connecting Magic Hour to Claude Web, Desktop, and Cowork
1. Open Customize
In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.
2. Add the Composio MCP server
Click Add custom connector and paste in the Composio MCP server URL:

```bash
https://connect.composio.dev/mcp
```

## 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.

## Troubleshooting

### 1. Why does Claude not use the Composio connector for Magic Hour?

The connector can show as connected, but Claude must use it in each Magic Hour conversation.
- Click + at the lower left of the chat, or type /.
- Hover Connectors.
- Turn on Composio.
- Ask Claude to connect to Magic Hour again.

### 2. Why does Claude show an MCP server error before Magic Hour connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Magic Hour.
- Check that the connector URL is https://connect.composio.dev/mcp.
- Connectors run from Anthropic's cloud, so your device network is usually not the problem.
- Add the connector again from Customize > Connectors, then ask Claude to connect Magic Hour.
- If it fails again, send the error and the ofid_ reference id to support@composio.dev.

### 3. Why does the Magic Hour authorization link not work?

The Composio connector is one server. Your Magic Hour account connects separately when Claude asks for it.
- If the browser does not open, or the link expires, ask Claude to retry the Magic Hour connection.
- Composio creates a fresh Magic Hour authorization link.
- Open that link in your browser and finish the Magic Hour sign-in.

### 4. Why do Magic Hour actions fail after they worked before?

The Magic Hour connection can expire or lose permission.
- Ask Claude to inspect the Magic Hour connection.
- If the connection is unhealthy, disconnect it when Claude prompts you.
- Reconnect the Magic Hour account and retry the action.
- If Claude shows a permission prompt, approve it before Claude changes data in Magic Hour.
- If the action still fails with a permission error, check that the connected account has that permission in Magic Hour itself.

### 5. How do I switch to a different Magic Hour account?

Claude can manage the Magic Hour connection for you.
- Ask Claude to disconnect or delete the current Magic Hour account.
- Ask Claude to connect Magic Hour again.
- Open the new Composio authorization link for Magic Hour.
- Sign in with the other Magic Hour account in the browser.
- After the account connects, ask Claude to retry the Magic Hour task.

### 6. Why is my Magic Hour connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Magic Hour connection works in Claude Web, Desktop, and Cowork.
- In Claude Desktop, open Customize > Connectors.
- Next to Composio, click ⋮ and click Clear cache.
- If Magic Hour tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
- On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Magic Hour.

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

The Magic Hour MCP server connects Claude Web, Desktop, and Cowork to your Magic Hour account through Composio. Once connected, Claude can use the available Magic Hour tools and triggers to complete tasks on your behalf.

## Complete Code

None listed.

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

- [ChatGPT Work](https://composio.dev/toolkits/magic_hour/framework/chatgpt)
- [Hermes](https://composio.dev/toolkits/magic_hour/framework/hermes-agent)

## 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 Claude Cowork?

Yes, you can. Claude Cowork 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)