{
  "markdown": "<p align=\"center\">\n  <a href=\"https://getklo.com\"><img src=\"https://getklo.com/og.jpg?v=3\" alt=\"klo, the native Mac video editor you talk to\" width=\"720\" /></a>\n</p>\n\n# klo-mcp: the video editing MCP server\n\n[![npm](https://img.shields.io/npm/v/klo-mcp?color=a8c152)](https://www.npmjs.com/package/klo-mcp)\n[![license](https://img.shields.io/badge/connector-MIT-a8c152)](./LICENSE)\n![platform](https://img.shields.io/badge/platform-macOS%2013%2B-0a0a0a)\n[![site](https://img.shields.io/badge/getklo.com-visit-f1ece5)](https://getklo.com)\n\nGive your coding agent a real video editor.\n\n[klo](https://getklo.com) is a native macOS video editor you talk to. This is\nits MCP server: Claude Code, Codex, Cursor, Claude Desktop, or any MCP client\ncan drive the whole timeline, with 83 tools, while your footage never leaves\nyour Mac.\n\n- **A real editor underneath.** Not an ffmpeg wrapper: ripple edits, word-gap\n  cuts, karaoke captions, color grades, generated music, ProRes export. Every\n  edit lands on a normal timeline a human can open and adjust.\n- **Media stays local.** Piping video bytes through a text protocol fails\n  (base64 versus context windows). klo holds the media on your machine and\n  exposes semantic timeline operations instead. The agent sends intent and\n  gets back compact results: timecodes, transcripts, real frames when it\n  needs to look.\n- **Local, token-gated, off by default.** The server listens on\n  `127.0.0.1` only, requires a bearer token, and does nothing until you turn\n  it on in klo's settings.\n\n## Quickstart\n\n1. [Get klo for Mac](https://getklo.com/api/download) (free tier included,\n   macOS 13+).\n2. In klo: **Settings → Connections**, turn the connection on, and copy the\n   URL and token it shows.\n3. Connect your client:\n\n### Claude Desktop (one click)\n\nDownload [klo.mcpb](https://getklo.com/klo.mcpb) and open it. Done.\n\n### Claude Code\n\n```sh\nclaude mcp add --transport http klo http://127.0.0.1:41720/mcp \\\n  --header \"Authorization: Bearer YOUR_TOKEN\"\n```\n\nUse the exact URL shown in klo's settings (the port can differ if 41720 is\ntaken).\n\n### Cursor, Codex, and other MCP clients\n\nEither point the client at the HTTP endpoint above, or use this package as a\nstdio server:\n\n```json\n{\n  \"mcpServers\": {\n    \"klo\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"klo-mcp\"],\n      \"env\": { \"KLO_MCP_TOKEN\": \"YOUR_TOKEN\" }\n    }\n  }\n}\n```\n\n## What your agent can do\n\nAsk in plain language, or call tools directly. A few real prompts:\n\n- \"Cut the boring parts and the filler words, then caption it word by word.\"\n- \"Watch this folder and turn every new recording into a captioned vertical\n  clip.\"\n- \"Pick the best take of each line from the transcript and assemble the cut.\"\n- \"Grade everything to match this reference and export ProRes for the client.\"\n\n## The 83 tools\n\n| group | tools |\n|---|---|\n| library | get_project_state, get_media_library, import_media, import_from_url, relink_to_sources, list_files, new_project |\n| timeline | add_media_to_timeline, assemble_cut, insert_at, move_clip, split_clip, split_audio, trim_clip, delete_clips, ripple_delete, close_gaps, separate_audio, unlink_clip, link_clips, replace_audio, add_marker, set_in_out, set_track_lock, seek, verify_timeline |\n| project | set_canvas_ratio, set_frame_rate, set_brand_kit |\n| cuts | add_transition, remove_transition, preview_cut, generate_transition, refine_transition |\n| type | add_text, update_text, add_captions_from_transcript, list_text_styles, list_fonts, search_fonts, use_font |\n| motion | list_motion_templates, create_motion_clip, update_motion_clip |\n| color | set_clip_grade, add_clip_effect, update_clip_effect, remove_clip_effect, list_luts, import_lut, set_clip_opacity, set_clip_blend |\n| frame | set_clip_transform, set_clip_speed |\n| audio | set_clip_audio, set_volume_envelope, duck_audio, analyze_audio, quantize_cuts_to_beats, isolate_voice_on_clip, measure_audio, measure_mix |\n| generate | generate_music, generate_sfx, generate_voiceover, clone_voice_from_clip, fix_spoken_line, generate_video |\n| read | get_transcript, find_repeated_takes, capture_frame, survey_footage, measure_frame, measure_clip |\n| remember | write_footage_notes, get_footage_notes, analyze_reference, save_style_profile, list_style_profiles, apply_style_profile |\n| out | delegate_research, web_search, export_video |\n\n## Pricing\n\nDriving the timeline over MCP is free: your agent brings its own model. The\nhandful of tools that generate new media (music, voiceover, generated shots)\nuse your klo account's credits, and the agent is told the price before it\nspends. New accounts get 10 free asks.\n\n## Security notes\n\n- Listens on `127.0.0.1` only. Nothing is exposed to the network.\n- Bearer token auth with constant-time comparison. Rotate the token from\n  klo's settings anytime.\n- Off by default. If klo is running but the connection is off, the server\n  tells your agent exactly that.\n- Voice cloning tools are consent-gated in the app.\n\n## Troubleshooting\n\n**\"klo is running but is not accepting connections\"**: turn the bridge on in\nklo → Settings → Connections, then copy the token into `KLO_MCP_TOKEN` (or\nthe Authorization header for HTTP).\n\n**Port differs from 41720**: klo falls back to an ephemeral port if the\npreferred one is taken. Always trust the URL shown in Settings.\n\n## About\n\nThis package is the thin connector; the editor itself is\n[klo](https://getklo.com). The connector mirrors the copy bundled inside the\napp, and its major.minor version tracks the app release it shipped with.\n\n## FAQ\n\n**Can Claude Code edit videos?**\nWith klo installed, yes. Claude Code connects to this server and gains cutting,\ncaptions, grading, generated music and voiceover, and ProRes export on a real\ntimeline. See [what agentic video editing is](https://getklo.com/blog/agentic-video-editing).\n\n**Is this an ffmpeg wrapper?**\nNo. Tools operate on klo's timeline (ripple edits, word-gap cuts, undo), and\nnothing is re-encoded between steps. [Why that design](https://getklo.com/blog/mcp).\n\n**Does my footage get uploaded?**\nNo. Media stays on the Mac; the server exchanges timeline operations and\ncompact results. Details in klo's [privacy policy](https://getklo.com/privacy).\n\n**What does it cost?**\nDriving the timeline is free with your own model. Generation tools use klo\naccount credits. [Pricing](https://getklo.com/#plans).\n\n## Related reading\n\n- [Give your coding agent a real timeline](https://getklo.com/blog/mcp)\n- [What is agentic video editing?](https://getklo.com/blog/agentic-video-editing)\n- [klo changelog](https://getklo.com/changelog): the app ships several times a week\n- [Download klo for Mac](https://getklo.com/api/download)\n\nMIT (this connector). klo is a product of klorah inc.\n[getklo.com](https://getklo.com)\n",
  "bytes": 6766,
  "sha": "8983ce7ede11739b7a988144e7004cf8c569ff79ff024e2fcd0c1e95de0e9571",
  "repo_slug": "elvniv/klo-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_getklo_klo_mcp_974c254c/readme"
}