
shotlog
Capture macOS windows into a numbered, captioned screenshot log and export it as a report.
- tools
- 6
- transport
- STDIO
- env var
- 1
- last updated
- Nov 9, 2026
Tools
6 toolsPublic tool metadata for what this MCP can expose to an agent.
list_windowsLists the visible windows (app, title, size).
Lists the visible windows (app, title, size).
No parameter schema in public metadata yet.
save_screenshotCaptures one window, picked by app and/or title (front-most by default), and saves it as 001_name.png together with its caption.
Captures one window, picked by app and/or title (front-most by default), and saves it as 001_name.png together with its caption.
No parameter schema in public metadata yet.
update_captionFills in or fixes the caption afterwards.
Fills in or fixes the caption afterwards.
No parameter schema in public metadata yet.
list_screenshotsShows the log in order.
Shows the log in order.
No parameter schema in public metadata yet.
pull_remote_screenshotsFetches new screenshots from another machine (e.g. Windows' Pictures\Screenshots) over SCP and numbers them in the same sequence.
Fetches new screenshots from another machine (e.g. Windows' Pictures\Screenshots) over SCP and numbers them in the same sequence.
No parameter schema in public metadata yet.
export_reportWrites report.md: every screenshot with its caption, in order.
Writes report.md: every screenshot with its caption, in order.
No parameter schema in public metadata yet.
Sponsors
Configuration
SHOTLOG_DIRFolder for screenshots, manifest.json and report.md (default: ~/shotlog)
Readme
shotlog-mcp
Let your AI assistant take the screenshots for your report.
An MCP server for macOS. It captures a specific window, saves it with a sequential number and a caption (activity, command, result), and puts everything together into a Markdown report you can turn into a PDF.
It was built for a university OS lab where every step had to be backed by a screenshot, on a Mac and a Windows laptop at the same time. It works the same way for QA evidence, tutorials, runbooks and bug reports.

What it does
Details
- Repository
- github.com/marlon-trujillo-jaramillo/shotlog-mcp
- Category
- Monitoring & Observability
- Package
shotlog-mcp- Transport
- STDIO
- Registry
- MCP registry, active