Enables AI agents to search local video and photo footage by meaning and automatically generate video cuts or montages.
Also known as reelary/cli, cli
- Stars
- 1
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.1.1
- Last commit
- Nov 7, 2026
- License
- MIT
What is Reelary MCP?
Reelary enables AI agents to search local video and photo footage by meaning and automatically generate video cuts or montages.
Summary generated from the project's README
About Reelary MCP server
Reelary allows AI agents to interact with your local video and photo collections on Mac or Windows. By indexing your files, it enables tools like Claude Desktop, Cursor, and Codex to search through every frame using semantic meaning. The system operates entirely on your computer, ensuring that no media files leave your local machine during the indexing or searching process.
Users can manage their media through specific skills such as find-footage, broll-finder, and rough-cut. The server supports creating vertical videos for platforms like TikTok and exporting projects via FCPXML, XML, or EDL formats for professional software like DaVinci Resolve, Premiere, or Final Cut. While the free tier offers unlimited indexing and 720p MP4 exports with watermarks, the Pro version adds features like dialogue search, people recognition, and full-quality exports.
Installation is handled via npx commands to set up the background application and connect it to your preferred AI client. You can use the command line to index specific directories, search for visual descriptions, or generate automated montages with specific aspect ratios.
What you can do with it
- 1Semantic media searchingAsk an AI agent to locate specific visual content like drone shots or coastal scenery within your local folders.
- 2Automated video montage creationInstruct a client to generate a short recap video from a specific trip using your existing footage.
- 3Script to video editingProvide a written script to an agent to produce a rough cut of video clips.
Written from the project's README. Every use case is checked against a quote from it.
How to install Reelary MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Reelary MCP in Claude Code
$ claude mcp add cli -- npx -y reelaryInstall Reelary MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"cli": {
"command": "npx",
"args": [
"-y",
"reelary"
]
}
}
}Install Reelary MCP in VS Code
.vscode/mcp.json
{
"servers": {
"cli": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"reelary"
]
}
}
}Install Reelary MCP in VS Code CLI
$ code --add-mcp '{"name":"cli","type":"stdio","command":"npx","args":["-y","reelary"]}'Install Reelary MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"cli": {
"command": "npx",
"args": [
"-y",
"reelary"
]
}
}
}Install Reelary MCP in Codex
$ codex mcp add cli -- npx -y reelaryInstall Reelary MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.cli] command = "npx" args = ["-y", "reelary"]
Install Reelary MCP in Gemini CLI
$ gemini mcp add -s user cli npx -- -y reelaryInstall Reelary MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"cli": {
"command": "npx",
"args": [
"-y",
"reelary"
]
}
}
}Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablereelary/cli is public and reachablegithub.com/reelary/cli ↗Pass
- Package names this repository as its sourcereelary names reelary/cli as sourcenpmjs.com/package/reelary ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-07github.com/reelary/cli ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from reelaryPass
- No critical advisory in the package or its dependencies4 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubReelary for AI agents
Talk to your footage. Reelary indexes the videos and photos already on your Mac or Windows PC and lets Claude, Cursor, Codex and other agents search every frame by meaning and cut the matches into a video. 100% local: nothing leaves your computer.
Install
npx reelary
Installs the signed Reelary app (runs in the background with a tray icon), connects it to Claude Code, Claude Desktop, Cursor and Codex, and adds the skills below.
Skills only (any of 60+ agents):
npx skills add reelary/skills
Claude Code plugin (skills + MCP server):
/plugin marketplace add reelary/skills
/plugin install reelary@reelary
What you can ask
- "Index ~/Movies and find drone shots of the coast."
- "Find b-roll for this voiceover: …"
- "Cut a 30-second 9:16 recap of my Lisbon trip."
- "Rough cut this script from my footage and export it for DaVinci Resolve."
Skills
| Skill | For |
|---|---|
| reelary | Start here: install, index folders and drives, troubleshoot |
| find-footage | Shots by description, photos, quotes (Pro), people (Pro), places and drone GPS (Pro) |
| broll-finder | B-roll for a voiceover or interview |
| rough-cut | Rough cuts, script-to-video, montages, highlight reels |
| vertical-video | Shorts, Reels, TikTok (9:16, 1:1) |
| nle-export | FCPXML / XML / EDL for Premiere, Final Cut, Resolve (Pro) |
Skills source: https://github.com/reelary/skills
Plans
Free: unlimited indexing, visual search, rough cuts; MP4 exports at 720p with a watermark, up to 60 seconds, 5 per month. Pro (one-time purchase, Mac + Windows): dialogue search, people, places, NLE export, full-quality unlimited exports. https://reelary.app/pricing
CLI
npx reelary status
npx reelary index ~/Movies
npx reelary search "sunset over water" --json
npx reelary cut "Sunrise over the city. Coffee being poured." --aspect 9:16 --save Morning
npx reelary export <project_id> [--nle fcpxml]
npx reelary uninstall [--app]
Reelary MCP questions
How do I add Reelary MCP to Claude Code?
Run claude mcp add cli -- npx -y reelary in your terminal. Add --scope user to make it available in every project.
How do I add Reelary MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Is my data private?
Yes, the tool is 100% local and nothing leaves your computer.
What are the limitations of the free plan?
The free plan includes unlimited indexing and visual search, but MP4 exports are limited to 720p with a watermark, up to 60 seconds, and 5 exports per month.