Skip to content
MCP server

Relay Remotify MCP

Run shell commands on a remote machine through an HTTPS relay, no SSH needed

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, Linux, macOS
Runs
Locally
Version
0.6.4
Listing updated
3 days ago

About Relay Remotify MCP

Relay Remotify MCP is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Giving an AI agent a long-lived SSH credential is a risk many teams would rather avoid. This stdio server routes commands through an HTTP relay instead. You paste a one-line listener, which needs only curl and bash, on the remote machine, and the assistant pushes commands that wait until the listener picks them up.

In supervised mode the listener prints each command and waits for you to type y on the remote terminal before it runs. Adding ?mode=auto to the URL switches to unattended execution. Sessions use a random 128-bit key with no accounts, and the relay discards session data after three hours idle. The README says the MCP package sends no telemetry and only talks to the relay you point it at.

By default it uses the free public relay at relay.remotify.run, which is Apache-2.0 open source, so you can self-host it by setting REMOTIFY_URL. It suits hosts behind NAT, headless devices and CI boxes that can dial out but not in.

Install

Run in a terminal

claude mcp add relay-remotify-mcp --env REMOTIFY_KEY='<REMOTIFY_KEY>' -- npx -y remotify-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "relay-remotify-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "remotify-mcp"
      ],
      "env": {
        "REMOTIFY_KEY": "<REMOTIFY_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "relay-remotify-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "remotify-mcp"
      ],
      "env": {
        "REMOTIFY_KEY": "<REMOTIFY_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "relay-remotify-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "remotify-mcp"
      ],
      "env": {
        "REMOTIFY_KEY": "<REMOTIFY_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "relay-remotify-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "remotify-mcp"
      ],
      "env": {
        "REMOTIFY_KEY": "<REMOTIFY_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "relay-remotify-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "remotify-mcp"
      ],
      "env": {
        "REMOTIFY_KEY": "<REMOTIFY_KEY>"
      }
    }
  }
}

Configuration

  • REMOTIFY_URLRelay to talk to. Override to point at a self-hosted instance.
  • REMOTIFY_KEYReuse an existing session key instead of creating a new one on startup.

Tools this server provides (3)

Taken from the project documentation; the running server may differ.

remote_exec
Sends a shell command to the remote listener and returns its output.
remote_session_info
Shows the session details and listener one-liners to paste on the remote.
remote_session_reset
Resets the relay session.

What it does

No SSH required
The remote needs only curl and bash and outbound HTTPS, with no inbound ports.
Supervised approval
Each command prints on the remote and waits for a y before running.
Auto mode
Appending ?mode=auto runs commands without asking.
Asynchronous delivery
Commands and results wait on the relay until the other side fetches them.
Self-hostable relay
Point REMOTIFY_URL at your own instance of the Apache-2.0 relay.
Ephemeral sessions
Keys are random hex with no account, and sessions are purged after 3 hours idle.

Good for

  • Let an assistant run commands on a server without handing it SSH access
  • Check release state after a deploy on a box CI cannot reach
  • Administer a machine behind NAT using only outbound HTTPS
  • Reach headless or edge devices that can dial out but not in

Pricing

Open source

Free public relay or self-host; Apache-2.0

Prices change. Check relay.remotify.run before you buy.

Relay Remotify MCP FAQ

Does the remote machine need anything installed?

No. The listener one-liner needs only curl and bash and leaves nothing installed.

Can I approve each command?

Yes. In supervised mode the remote terminal prompts for y before each command; auto mode skips this.

Can I host the relay myself?

Yes. The relay is Apache-2.0 open source and REMOTIFY_URL points the server at another instance.

Which clients are documented?

Claude Code, Codex CLI, OpenCode, Cursor, Windsurf, Claude Desktop and Gemini CLI.

Is Relay Remotify MCP free?

Yes. Relay Remotify MCP is open source, so you can use and self-host it for free.

How do I add Relay Remotify MCP to Claude Code?

Run this command in your terminal: claude mcp add relay-remotify-mcp --env REMOTIFY_KEY='<REMOTIFY_KEY>' -- npx -y remotify-mcp

What are the best alternatives to Relay Remotify MCP?

The closest alternatives to Relay Remotify MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to Relay Remotify MCP

  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