Editly MCP Server

An MCP (Model Context Protocol) server that enables video editing capabilities through Editly in Claude Desktop, Cursor, and other MCP-compatible tools.

Features

• Merge video clips with smooth transitions
• Create slideshows from images
• Add titles to videos (start, end, or overlay)
• Trim videos to specific time ranges
• Add or replace audio in videos
• Advanced video creation with custom specifications

Prerequisites

• Node.js 18 or higher
• FFmpeg installed and available in PATH
  • macOS: brew install ffmpeg
  • Windows: Download from ffmpeg.org
  • Ubuntu: sudo apt install ffmpeg

Installation

npm install -g @moeloubani/editly-mcp

Configuration

Claude Desktop

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "editly": {
      "command": "npx",
      "args": ["@moeloubani/editly-mcp"]
    }
  }
}

Cursor

Add to your Cursor settings:

{
  "mcp.servers": {
    "editly": {
      "command": "npx",
      "args": ["@moeloubani/editly-mcp"]
    }
  }
}

Available Tools

1. merge_clips

Combine multiple video clips into one video.

Example prompt: "Merge video1.mp4 and video2.mp4 with a fade transition and save to output.mp4"

2. create_slideshow

Create a video slideshow from images.

Example prompt: "Create a slideshow from image1.jpg, image2.jpg, and image3.jpg with 5 seconds per image"

3. add_title

Add title text to your video.

Example prompt: "Add the title 'My Vacation 2024' to the beginning of vacation.mp4"

4. trim_video

Cut a video to a specific time range.

Example prompt: "Trim video.mp4 from 10 seconds to 30 seconds"

5. add_audio

Add background music or replace audio.

Example prompt: "Add background.mp3 as background music to myvideo.mp4"

6. create_video

Create videos with advanced custom specifications.

Example prompt: "Create a video with custom layers and effects using an Editly spec"

Usage Examples

Basic Video Merge

"Merge clip1.mp4 and clip2.mp4 with a crossfade transition and save to final.mp4"

Slideshow with Music

"Create a slideshow from my vacation photos in /photos folder with background music.mp3"

Add Opening Title

"Add 'Welcome to Our Channel' as a 5-second intro to video.mp4"

Trim and Add Music

"Trim interview.mp4 from 1:30 to 5:00 and add background_music.mp3 at 50% volume"

Output Settings

Default output settings:

• Resolution: 1280x720 (720p)
• Format: MP4
• Quality: 80%
• FPS: 30

These can be customized when using the advanced createVideo tool.

Troubleshooting

"Could not find the file"

• Check that the file path is correct and absolute
• Ensure the file exists and you have read permissions

"Video processing error"

• Verify FFmpeg is installed: ffmpeg -version
• Ensure FFmpeg is in your system PATH

"Permission denied"

• Check write permissions for the output directory
• Ensure the output path is valid

Development

# Clone the repository
git clone https://github.com/moeloubani/editly-mcp
cd editly-mcp

# Install dependencies
npm install

# Build
npm run build

# Run in development
npm run dev

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Support

For issues and feature requests, please visit GitHub Issues.