Skip to content
MCP server

Hostbeam

Let a coding agent on your server read the screenshots you beam to it

Runs locallyStatus and history
Install
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/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@hostbeam/mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@hostbeam/mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools