Magic Hour MCP Server

Local setup required. This server has to be cloned and prepared on your machine before you register it in Claude Code.
1

Set the server up locally

Run this once to clone and prepare the server before adding it to Claude Code.

Run in terminal
npm install
npm run build
2

Register it in Claude Code

After the local setup is done, run this command to point Claude Code at the built server.

Run in terminal
claude mcp add -e "MAGIC_HOUR_API_KEY=${MAGIC_HOUR_API_KEY}" magic-hour -- node "<FULL_PATH_TO_MAGIC_HOUR_MCP>/dist/index.js"

Replace <FULL_PATH_TO_MAGIC_HOUR_MCP>/dist/index.js with the actual folder you prepared in step 1.

Required:MAGIC_HOUR_API_KEY
README.md

Face swap videos, face swap photos, lip sync, face detection, and file management.

Magic Hour MCP Server

MCP server for Magic Hour AI — face swap videos, face swap photos, lip sync, face detection, and file management.

Tools

Tool Description
face_swap_video Swap a face onto a video (file/URL source)
face_swap_video_youtube Swap a face onto a YouTube video
face_swap_video_individual Swap specific faces using face detection IDs
face_swap_photo Swap a face onto a photo
detect_faces Detect faces in an image or video
get_face_detection_result Get detected face IDs and URLs
lip_sync Sync lip movements to an audio track
upload_file Upload a file to Magic Hour storage
get_video_project_status Check video project status and get download URLs
get_image_project_status Check image project status and get download URLs
delete_video_project Delete a video project
delete_image_project Delete an image project

Setup

  1. Get an API key from magichour.ai/settings/developer

  2. Install dependencies:

npm install
  1. Build:
npm run build

Claude Desktop Configuration

Add to ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "magic-hour": {
      "command": "node",
      "args": ["/path/to/magic-hour-mcp/dist/index.js"],
      "env": {
        "MAGIC_HOUR_API_KEY": "mhk_live_your_key_here"
      }
    }
  }
}

Claude Code Configuration

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "magic-hour": {
      "command": "node",
      "args": ["/path/to/magic-hour-mcp/dist/index.js"],
      "env": {
        "MAGIC_HOUR_API_KEY": "mhk_live_your_key_here"
      }
    }
  }
}

Usage Example

Face swap a dance video:
1. Upload your face image: upload_file → get file_path
2. Start face swap: face_swap_video with video URL + face file_path
3. Poll status: get_video_project_status until "complete"
4. Download from the returned URL

Individual face swap:
1. Detect faces: detect_faces on the source video
2. Get results: get_face_detection_result to see all faces
3. Swap specific faces: face_swap_video_individual with face mappings

License

MIT

Tools (12)

face_swap_videoSwap a face onto a video (file/URL source)
face_swap_video_youtubeSwap a face onto a YouTube video
face_swap_video_individualSwap specific faces using face detection IDs
face_swap_photoSwap a face onto a photo
detect_facesDetect faces in an image or video
get_face_detection_resultGet detected face IDs and URLs
lip_syncSync lip movements to an audio track
upload_fileUpload a file to Magic Hour storage
get_video_project_statusCheck video project status and get download URLs
get_image_project_statusCheck image project status and get download URLs
delete_video_projectDelete a video project
delete_image_projectDelete an image project

Environment Variables

MAGIC_HOUR_API_KEYrequiredAPI key obtained from magichour.ai/settings/developer

Configuration

claude_desktop_config.json
{"mcpServers": {"magic-hour": {"command": "node", "args": ["/path/to/magic-hour-mcp/dist/index.js"], "env": {"MAGIC_HOUR_API_KEY": "mhk_live_your_key_here"}}}}

Try it

→Upload my face image and use it to perform a face swap on this video file.
→Detect all faces in the provided video and list their detection IDs.
→Perform a lip sync on this video using the provided audio track.
→Check the status of my current video project and provide the download link if it is complete.

Frequently Asked Questions

What are the key features of Magic Hour?

AI-powered face swapping for both photos and videos. Lip syncing capabilities for video content. Automated face detection and identification. File management for uploading and tracking media projects. Support for processing YouTube video URLs.

What can I use Magic Hour for?

Creating personalized video content by swapping faces into existing footage. Automating lip-syncing for dubbed or localized video projects. Extracting and identifying faces from large batches of media files. Managing media processing workflows directly from the Claude interface.

How do I install Magic Hour?

Install Magic Hour by running: npm install && npm run build

What MCP clients work with Magic Hour?

Magic Hour works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Magic Hour docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare
View all ai-tools servers →

Related MCP Servers

Skill Seekers
The data layer for AI systems.
ai-tools11.1K stars
Context Mode
The other half of the context problem.
ai-tools5.6K stars
Semiotic
A React data visualization library designed for AI-assisted development.
ai-tools2.6K stars
RocketRide
Self-hosted, open-source AI pipeline platform for MCP tools
ai-tools1.6K stars
Context+
Semantic Intelligence for Large-Scale Engineering.
ai-tools1.5K stars
ShipSwift
AI-native SwiftUI component library — production-ready code for LLMs
ai-tools1.3K stars