Local MCP server
Your recordings, as context for AI.
Kamo ships a small MCP server that lets Claude Code, or any MCP client, read what you recorded on this computer: names and dates, what was said, where you clicked, the zooms, and a screenshot every 5 seconds.
- Read-only
- No network
- Runs on your machine
- Free and MIT
How it works
Your projects folder
Recordings saved by the Kamo desktop app
Kamo MCP
Started by your agent as a local process, over stdio
Your agent
Claude Code, Cursor, or any MCP client
A conversation, live.
You ask in plain words. Your agent calls Kamo’s tools, reads the transcript and the clicks, grabs the screenshots and answers.
Connect it in minutes
The desktop app shows the exact command, with your folder already filled in, under Settings → Connect to an agent.
Until the package is on npm, build the server from a clone of the repository and point your agent at it.
git clone https://github.com/dssiqueira/kamo && cd kamo pnpm install && pnpm --filter @kamo/mcp build claude mcp add kamo -- node "<path to kamo>/apps/mcp/dist/cli.js" --dir "<projects folder>"
Once @kamo/mcp is published, this is all it takes. --dir is optional: without it, the server finds the folder set in the app.
claude mcp add kamo -- npx -y @kamo/mcp --dir "<projects folder>"
Any client that can start a stdio server works. This is the usual JSON config.
{
"mcpServers": {
"kamo": {
"command": "npx",
"args": ["-y", "@kamo/mcp", "--dir", "/Users/you/Kamo/projects"]
}
}
}On Windows, some clients need "command": "cmd" and "args": ["/c", "npx", …].
Eight tools. All read-only.
Times come in milliseconds and as hh:mm:ss. Positions are pixels of the recorded video. Long lists are paginated.
| Tool | What it returns |
|---|---|
list_recordings | Recordings, newest first: name, date, duration, resolution, transcript and export info. |
search_recordings | Matches in names and transcripts, with a snippet and the exact instant. |
get_recording | Full metadata of one recording: trim, zooms, style, cursor, audio tracks, exports. |
get_transcript | Timed transcript segments, all of them or a time range. |
get_click_timeline | Clicks and zooms with instant and position; scrolls and moves when asked. |
get_frame | The reference screenshot closest to an instant, as an image. |
list_playlists | The local playlists you made in the app. |
get_playlist | One playlist with its recordings, in order. |
Things you can ask
“What did I record last week?”
list_recordings { "from": "2026-10-26", "to": "2026-11-01" }“Find the recording where I talked about billing settings.”
search_recordings { "query": "billing settings" }“Write step-by-step docs from my onboarding demo.”
get_transcript · get_click_timeline · get_frame ×3“What was on screen at 1:05?”
get_frame { "atMs": 65000 }“Summarize every video in my Release notes playlist.”
get_playlist { "playlist": "Release notes" } → get_transcript
Private by design
Read-only
It only reads your projects folder. No tool creates, changes or deletes a file. Raw videos are never opened.
No network
It never opens a socket or makes a request. Tests scan the source and run every tool with the network blocked.
No video decoding
Screenshots come from small reference frames saved while recording. No FFmpeg, no native binary.
Your agent, your call
What your agent does with the answers, like sending them to its model provider, is up to the agent you connected.
When something is missing
- No transcript?
- Transcription is an optional pack in the desktop app (Transcribe in the Editor, or Settings → Optional packs). Without it, clicks, zooms and frames still work.
- Recorded in the Chrome extension?
- Those recordings live inside the browser, so the local server can't see them. That's what the cloud MCP is for.
- No recordings found?
- The answer says which folder was read. Check the folder in the Kamo app and pass it with --dir.
Local MCP vs cloud MCP
Local MCPAvailable now
Free, in the app today. Reads the recordings on this computer.
Cloud MCPComing soon
With Kamo Cloud (coming soon). Your whole library from any device, plus actions: create links and playlists.
Questions
Which agents work with it?
Any MCP client that can start a stdio server: Claude Code, Claude Desktop, Cursor, Windsurf and others. The app shows the command for Claude Code.
Does it send my recordings anywhere?
The server itself never touches the network. It answers the agent you connected; what that agent does with the answers is up to it.
Do I need the transcription pack?
No. Without it the agent still gets names, dates, clicks, zooms and screenshots. With it, the agent can also search and quote what you said.
Try it on your next recording.
Free, open source, no account. Your first edited video is one download away.