MCP serverPartly tested (needs an account)
Record your screen for your assistant
OpenRecord
Mac menu bar app that records your screen and voice, transcribes it on your computer, and lets your assistant read the transcript and screenshots.
- Works with
- Claude Code, Codex CLI
- Good for
- Daily work and research, Build an app
What it does
OpenRecord is a small Mac app that lives in the menu bar. You press one key combination, talk while you show something on screen, and press it again to stop. It saves a video of your screen with your voice.
After each recording, it writes down what you said on your own Mac, using the free whisper.cpp speech-to-text engine. Nothing is uploaded and there is no account.
Its connector (an MCP server, a standard way to plug tools into assistants) lets Claude Code or Codex list your recordings, read what you said, search all recordings for a phrase and take screenshots from any moment. So instead of typing a long bug report, you can show the problem and say "watch my latest recording".
Example prompts
- "Watch my latest OpenRecord recording and fix the bug I describe." (from the README)
- "Find where I talked about the invoice total and show me the screen at that moment." (from the README)
- "Summarize my last three recordings." (from the README)
How to install
Download OpenRecord-<version>.zip from https://github.com/dorukgunes/openrecord/releases/latest, unzip it and move OpenRecord to Applicationsclaude mcp add --scope user openrecord -- /Applications/OpenRecord.app/Contents/MacOS/openrecord-mcpHow to use it
Press Control-Option-Command-R, talk through what you see, and press it again to stop. Then ask your assistant to watch your latest recording.
Check it works
After the first recording, the menu bar's Recent Recordings shows it as transcribed after a few seconds. In Claude Code, /mcp lists openrecord; asking for list_recordings returns your newest recordings first.
Common problems
- Recording is blank or silent — macOS has not given permission — allow OpenRecord under System Settings › Privacy & Security › Screen & System Audio Recording and Microphone, then reopen it — https://github.com/dorukgunes/openrecord
- No transcript — whisper.cpp is not installed — choose Set Up Transcription… in the menu, then Check Again — https://github.com/dorukgunes/openrecord
- A monthly macOS question about bypassing the private window picker — the README says to choose Allow; OpenRecord records only your microphone, not system audio — https://github.com/dorukgunes/openrecord
- Your assistant sees no recordings — the app and the connector read different folders — if you set OPENRECORD_LIBRARY for one, set it for both — https://github.com/dorukgunes/openrecord
Other assistants
- Codex CLI: add [mcp_servers.openrecord] with command = "/Applications/OpenRecord.app/Contents/MacOS/openrecord-mcp" to ~/.codex/config.toml (README). Gemini CLI is not listed — https://github.com/dorukgunes/openrecord
What to watch out for
- Needs Screen Recording and Microphone permission on your Mac; recordings, transcripts and video stay in ~/Movies/OpenRecord
- Transcription setup opens Terminal, runs brew install whisper-cpp if whisper-cli is missing, and downloads about 575 MB of models from Hugging Face
- Transcripts and screenshots the assistant reads go to its model provider, so do not record passwords or private data
- macOS 15 or later. The download is built for Apple silicon only and does not run on Intel Macs; building from source on Intel is untested. Very new: repo created 2026-11-04, first release 0.1.0 on 2026-11-05
Licence and author
- Licence
- MIT
- Author
- dorukgunes (Doruk Güneş)
- Source code
- github.com/dorukgunes/openrecord
How we tested it
We installed it on an empty test computer on 10 Nov 2026. Partly tested: installed in a clean test system, but its main features need an account or key we did not use.
Technical details of the test
- Date
- 10 Nov 2026
- Method
- Reviewed by our team against the repository, its README and docs.
Checked again on 10 Nov 2026
Alternatives
- minutes — records and transcribes meetings and voice memos on your computer; OpenRecord adds screen video and screenshots your assistant can look at
FAQ
- Q: Does it need the internet? A: No. The README says the app and its connector make no network requests, and we found no network code in the source. Only the transcription setup downloads whisper.cpp (Homebrew) and models (Hugging Face).
- Q: Can my assistant change or delete recordings? A: No. All five tools only read files, and the connector talks to your assistant only over a local pipe (stdio). To delete a recording, delete its folder.
- Q: Does it record my webcam? A: No. It records one display and your microphone.
Sources
- github.com/dorukgunes/openrecord
- github.com/dorukgunes/openrecord/releases/tag/v0.1.0