Framea MCP Server

The Framea MCP server lets AI assistants like Claude and ChatGPT search your photos and videos in plain language. Connect it with a single URL, sign in with Google, and your assistant can find any moment by what was said, shown, or written on screen, then deep-link you straight to it.

Server URL

https://api.framea.cloud/mcp

What it does

Framea indexes every photo and video in your library by audio transcript, on-screen text, and visual scene. The MCP server exposes that index to any Model Context Protocol client, so an assistant can run a search, follow up with “more like this,” and fetch a playback link, all scoped to your own account.

Connect it

Framea is a remote MCP server, so there is nothing to install. Authentication runs over Google OAuth, so connecting always opens a browser sign-in.

Clients with remote-server support (Claude.ai, Claude Desktop)

Add a custom connector and paste the server URL above. A Google sign-in window opens; use the same email as your Framea account and the three tools appear in your chat.

Clients that only run local servers

Bridge to the remote server with mcp-remote in your client's config:

{
  "mcpServers": {
    "framea": {
      "command": "npx",
      "args": ["mcp-remote", "https://api.framea.cloud/mcp"]
    }
  }
}

The first call opens a browser for Google sign-in; the session is cached afterward.

Authentication

Sign-in uses Google OAuth. The server maps your Google email to a Framea account, so the Google address you sign in with must match your Framea account email. If no account exists for that email, sign up at framea.cloud first. Every tool call is scoped to your library and yours alone.

Tools

search_media(query, media_type?, limit?, mode?)

The primary tool. Searches your library by describing a moment in plain language, across speech transcripts, on-screen text, scene descriptions, and visual appearance. Returns matches ranked by relevance, each with a deep link to the exact moment.

query: Plain-language description of the moment you want.
media_type: Optional. “video” or “photo” to filter.
limit: Optional. Number of results (1–50, default 10).
mode: Optional. “auto” (default, best overall) or “visual” to match purely on how a frame looks.

find_similar(media_id, limit?)

Given a media_id, returns items visually similar to it, useful for “more like this” browsing after a search hit.

media_id: The id of an existing item to match against.
limit: Optional. Number of results (1–50, default 10).

get_media(media_id)

Returns details for one item by id, including its status, duration, a thumbnail, and a temporary playback URL once the media has finished processing.

media_id: The id of the item to fetch.

Results come back as clean JSON for the model: ids, snippets, relevance scores, timestamps, and an open_url that deep-links to the exact moment (for videos, with the timestamp in the link).

Try these prompts

“Find the part of my keynote where I talk about pricing.”
“Show me beach videos from last summer.”
“Pull a wide shot of the city at night from my b-roll.”
“Find clips that look like this one.”

Frequently asked questions

What is the Framea MCP server?

It is a remote Model Context Protocol (MCP) server that exposes your Framea media library to AI assistants. Once connected, an assistant like Claude can search your photos and videos, find visually similar media, and pull a playback link, all scoped to your own account.

How do I connect Framea to Claude?

Add a custom connector pointing to https://api.framea.cloud/mcp. A Google sign-in window opens; sign in with the same Google email as your Framea account and the tools become available in your chat.

Do I need a Framea account?

Yes. The MCP server matches your Google identity to a Framea account by email. If no account exists for that email, sign up at framea.cloud first, then connect.

Is my media exposed to other users?

No. Every tool call resolves the authenticated Google identity to your Framea account and queries only your library. Other users cannot reach your media through the server.

Your library, in your assistant.

Framea makes every photo and video you own searchable by describing the moment. Free during beta on the web and iPhone.