# Hostbeam

> Hostbeam is an open-source MCP server for developer tools. Let a coding agent on your server read the screenshots you beam to it. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, self-hosted
- **Website:** https://hostbeam.app
- **Repository:** https://github.com/punkabeat/hostbeam-mcp
- **MCP Registry name:** app.hostbeam/mcp
- **Categories:** developer tools
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp -- npx -y @hostbeam/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@hostbeam/mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@hostbeam/mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@hostbeam/mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@hostbeam/mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@hostbeam/mcp"
      ]
    }
  }
}
```

## Tools

- `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.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/hostbeam
