Hostbeam MCP server
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Hostbeam MCP server
Hostbeam sends a screenshot from your Mac or your iPhone to a server over SSH and puts the remote path on your clipboard, so you can paste it to a coding agent running there.
This MCP server runs on that server, next to the agent. The agent can ask for the screenshot you just beamed and read it, without you pasting the path.
Install
On the server your agent runs on, not on your Mac or your phone. Node 18 or later.
For Claude Code:
claude mcp add -s user hostbeam -- npx -y @hostbeam/mcp-s user makes it available in every project on that server.
For Codex:
codex mcp add hostbeam -- npx -y @hostbeam/mcpFor other MCP clients, in their JSON config:
{
"mcpServers": {
"hostbeam": {
"command": "npx",
"args": ["-y", "@hostbeam/mcp"]
}
}
}If the server can't reach npm, copy hostbeam-mcp.mjs to it and run that
instead. It has no dependencies.
claude mcp add -s user hostbeam -- node /path/to/hostbeam-mcp.mjsHostbeam beams to /tmp/hostbeam unless you changed the folder for that host.
If you did, give the server the same folder: -e HOSTBEAM_DIR=/your/folder for
Claude Code, --env HOSTBEAM_DIR=/your/folder for Codex, or
"env": { "HOSTBEAM_DIR": "/your/folder" } in JSON.
Related MCP server: PeepIt MCP
Tools
latest_screenshotreturns the most recent beam as images, with how long ago it arrived. If you beamed several files at once, it returns all of them, up to six, and names the rest.list_screenshotslists recent beams with file names, sizes and times. No image data.read_screenshotreturns one file by name.
What it reads
Only files Hostbeam delivered: names starting with hostbeam- with an image
extension, in that one folder. It doesn't look in subfolders, and it refuses a
name with a path in it. It never writes, moves or deletes anything.
It skips symlinks, and it won't read a folder that belongs to another user or that any user can write to, because a file there may not be one you beamed.
JPEG, PNG, GIF and WebP come back as images, up to 3.75 MB each. Other formats
and larger files come back as a path instead: models only accept those four
formats, and model APIs refuse bigger images. When a beam holds several files,
latest_screenshot includes images up to 7.5 MB in total and names the rest.
Check it by hand
It speaks newline-delimited JSON-RPC on stdin and stdout:
printf '%s\n' \
'{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}' \
'{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"list_screenshots"}}' \
| npx -y @hostbeam/mcpLicense
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Capture website screenshots, run bulk captures, and manage screenshot schedules and history.
A real browser for your agent: screenshots, page checks, Markdown and PDFs.
Use your Mac, Windows or Linux computer from ChatGPT, Claude or Codex: files, commands, documents.
Hosted browser for agents: open pages, search the web, extract data, read PDFs and take screenshots.
Related MCP Servers
- AlicenseDqualityDmaintenanceEnables AI assistants to capture and analyze screenshots using Claude Vision API, providing AI-powered insights about desktop interface content, UI elements, and visual layouts.259 npm2MIT
- AlicenseAqualityDmaintenanceEnables AI agents to capture and analyze screenshots of macOS applications, windows, or the entire screen using local (Ollama) or cloud-based AI vision models, with non-intrusive, fast screen capture via Apple's ScreenCaptureKit.323 npm2MIT
- FlicenseAqualityDmaintenanceEnables LLMs to capture screenshots and screen recordings through MCP with chunked session-based transfers for reliable image consumption. Supports multi-monitor selection, timeline capture, and compatibility with both vision and non-vision language models.111-
- AlicenseAqualityDmaintenanceEnables Claude to capture screenshots of the screen, windows, regions, and web pages, and compare screenshots for visual regression testing.6MIT