Hostbeam
Let a coding agent on your server read the screenshots you beam to it
- Pricing
- Open source
- Platforms
- CLI, Linux, self-hosted
- Runs
- Locally
- Version
- 0.1.4
- Listing updated
- 1 day ago
About Hostbeam
Hostbeam is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
Hostbeam sends screenshots and files from a Mac or iPhone to a remote host over your own SSH and copies the remote path to your clipboard. This MCP server is the companion that runs on that host beside the agent, so the agent can fetch the latest beam itself instead of waiting for you to paste a path. The README lists Claude Code and Codex install commands, using npx or a dependency-free script.
Three tools are provided: latest_screenshot returns the most recent beam as images with its age, list_screenshots lists recent files without image data, and read_screenshot returns one file by name. It only reads files named with the hostbeam- prefix and an image extension in a single folder, defaulting to /tmp/hostbeam, and it refuses names containing paths, skips symlinks and ignores folders another user owns or anyone can write to. It never writes, moves or deletes.
JPEG, PNG, GIF and WebP up to 3.75 MB are returned as images; other formats and larger files come back as a path. The package is MIT licensed, and the Hostbeam apps are described as free with no account or telemetry.
Install
Run in a terminal
claude mcp add mcp -- npx -y @hostbeam/mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@hostbeam/mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@hostbeam/mcp"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@hostbeam/mcp"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@hostbeam/mcp"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@hostbeam/mcp"
]
}
}
}Configuration
HOSTBEAM_DIRThe folder Hostbeam beams to on this server. Leave unset for /tmp/hostbeam.
Tools this server provides (3)
Taken from the project documentation; the running server may differ.
- latest_screenshot
- Returns the most recent beam as images.
- list_screenshots
- Lists recent beams with names, sizes and times.
- read_screenshot
- Returns one beamed file by name.
What it does
- Latest beam
- Returns the newest screenshot as an image.
- Listing
- Shows recent beams with names, sizes and times.
- Read by name
- Fetches one specific file.
- Read-only
- Never writes, moves or deletes files.
- Strict folder rules
- Skips symlinks and unsafe folders.
- Configurable folder
- Set HOSTBEAM_DIR to match your beam location.
Good for
- Show an agent a UI bug from your phone
- Let an agent review a screenshot of its build
- Check what you last sent to the server
- Handle several beamed files at once
Pricing
Open source
MIT licensed; the Hostbeam apps are free
Prices change. Check hostbeam.app before you buy.
Hostbeam FAQ
Where do I install it?
On the server where the agent runs, not on your Mac or phone.
What does it need?
Node 18 or later.
What file types are returned as images?
JPEG, PNG, GIF and WebP up to 3.75 MB each.
Can it change files?
No. It only reads.
Is Hostbeam free?
Yes. Hostbeam is open source, so you can use and self-host it for free.
How do I add Hostbeam to Claude Code?
Run this command in your terminal: claude mcp add mcp -- npx -y @hostbeam/mcp
What are the best alternatives to Hostbeam?
The closest alternatives to Hostbeam are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to Hostbeam

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools