Skip to content
Back to search

capcut-ai-editor

AI Capcut MCP server for automated "talking head" video processing. Removes pauses, detects duplicate takes, adds subtitles — and exports to CapCut project.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/mrbuslov--capcut-ai-editor/badge.svg)](/listings/mrbuslov--capcut-ai-editor)

HTML

<a href="/listings/mrbuslov--capcut-ai-editor"><img src="/api/listings/mrbuslov--capcut-ai-editor/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

cd capcut-ai-editor
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
pip install -e .

For optional OpenAI-enhanced duplicate detection:

pip install -e ".[openai]"

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 95 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # SmartCut MCP Server
  2. MCP server for automated "talking head" video editing. Reads CapCut's auto-generated subtitles to find and remove silences and duplicate takes — directly in the CapCut project.
  3. ## How it works
  4. 1. Record your video, import into CapCut
  5. 2. Generate subtitles in CapCut (Text → Auto Captions)
  6. 3. Close CapCut
  7. 4. Ask Claude: "Smart cut my 'Podcast Episode 5' project"
  8. 5. Reopen in CapCut, review the cuts
  9. SmartCut reads CapCut's subtitles to understand where speech is. Gaps between subtitles > 1 second are cut. If the speaker repeats a phrase (duplicate take), earlier attempts are removed and the last version is kept.
  10. **No API keys required** — heuristic analysis works locally. Optionally set `OPENAI_API_KEY` for GPT-enhanced duplicate detection.
  11. ## Requirements
  12. - Python 3.10+
  13. - CapCut (for editing and subtitle generation)
  14. ## Installation
  15. ```bash
  16. cd capcut-ai-editor
  17. python -m venv venv
  18. source venv/bin/activate # Windows: venv\Scripts\activate
  19. pip install -e .
  20. ```
  21. For optional OpenAI-enhanced duplicate detection:
  22. ```bash
  23. pip install -e ".[openai]"
  24. ```
  25. ## Claude Code / Claude Desktop Setup
  26. Add to MCP config:
  27. ```json
  28. {
  29. "mcpServers": {
  30. "smartcut": {
  31. "command": "/path/to/capcut-ai-editor/venv/bin/python",
  32. "args": ["-m", "smartcut.server"]
  33. }
  34. }
  35. }
  36. ```
  37. Optional env for GPT-enhanced duplicates:
  38. ```json
  39. "env": {
  40. "OPENAI_API_KEY": "sk-..."
  41. }
  42. ```
  43. ## Usage
  44. **List projects:**
  45. ```
  46. Show me my CapCut projects
  47. ```
  48. **Inspect a project:**
  49. ```
  50. Open CapCut project "My Vlog"
  51. ```
  52. **Smart cut (main function):**
  53. ```
  54. Smart cut my "Podcast Episode 5" project
  55. ```
  56. **With OpenAI enhancement:**
  57. ```
  58. Smart cut "My Video" with use_openai=true
  59. ```
  60. **Warning:** Smart cut modifies the project in place (no backup). Make a copy in CapCut first if you want to keep the original.
  61. ## Environment Variables
  62. | Variable | Required | Description |
  63. |----------|----------|-------------|
  64. | OPENAI_API_KEY | No | OpenAI API key (for GPT-enhanced duplicate detection) |
  65. | CAPCUT_DRAFTS_DIR | No | Path to CapCut drafts folder (auto-detected) |
  66. ## Troubleshooting
  67. **"No auto-generated subtitles found"**
  68. Open the project in CapCut, select the video track, use Text → Auto Captions, save, then try again.
  69. **CapCut doesn't see changes**
  70. Restart CapCut. It monitors the drafts folder but sometimes needs a restart.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.