Relay Remotify MCP
Run shell commands on a remote machine through an HTTPS relay, no SSH needed
- 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-mcpAdd 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

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