Can MediaFind work with AI agents through MCP?

Yes. MediaFind includes a Model Context Protocol server so MCP clients such as Claude Desktop, Claude Code, Cursor, and other agents can search and query your local media library.

Does the MCP server upload my footage?

No. The MediaFind MCP server runs on your machine and uses the same on-device index as the desktop app and CLI. Footage is not uploaded by MediaFind.

What can an AI agent do with MediaFind?

Agents can run semantic media search, ask questions over the indexed library, read transcript segments and summaries for a file, check library status, and, with Pro, list clustered people and faces.

What privacy boundary should I understand?

Search and status stay fully local. When you ask an agent to read answers or transcripts, MediaFind returns local text to that agent, and the model you chose for that agent can see that text.

MediaFind for AI agents (MCP)

MediaFind ships an MCP server so Claude Desktop, Claude Code, Cursor, or any MCP client can search, ask, and read transcripts across your local library — nothing uploaded, keyless, on-device.

Privacy note. Search and status stay fully local. The ask_library and transcript tools return on-device text into the agent's model, which you choose.

Install

The MCP server is an optional extra on top of the normal MediaFind install:

pip install "mediafind[mcp]"

That adds the mediafind-mcp command (a stdio MCP server) and the mediafind mcp subcommand. Zero-install runners work too:

uvx --from "mediafind[mcp]" mediafind-mcp

Index a folder once so the agent has something to search (this is the same index the desktop app and CLI use — if you already run MediaFind, it's already built):

mediafind index ~/Movies

Claude Code

claude mcp add mediafind -- mediafind-mcp

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) and add:

{
  "mcpServers": {
    "mediafind": {
      "command": "mediafind-mcp"
    }
  }
}

Restart Claude Desktop. If mediafind-mcp isn't on Claude Desktop's PATH, use the absolute path (e.g. the one from which mediafind-mcp).

Cursor / Windsurf / other MCP clients

Add a stdio server whose command is mediafind-mcp (no args). The JSON shape matches the Claude Desktop block above.

{
  "mcpServers": {
    "mediafind": {
      "command": "mediafind-mcp"
    }
  }
}

Tools exposed

Tool	Tier	What it does
`search_media`	Free	Natural-language / multimodal search over the indexed library; returns matching clips with timestamps.
`ask_library`	Free	Ask a question and get a synthesized answer with cited sources + timestamps (local LLM).
`get_transcript`	Free	Return the transcript segments + summary for one indexed file.
`library_status`	Free	Index size, entitlement, trial state, upgrade link.
`list_people`	Pro	Clustered people/faces roster.

Pro-gated tools return a structured pro_required result (with the upgrade link and price) for free users instead of erroring — so an agent can surface the upgrade path.

Give your AI agent eyes and ears on your footage — locally.

Install

Claude Code

Claude Desktop

Cursor / Windsurf / other MCP clients

Tools exposed

Put your local media library inside your agent's reach.