# Shell Drop

> Shell Drop is a free MCP server for developer tools. Read-only SSH, tmux and Tailscale help for checking on AI agents from a phone. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API
- **Website:** https://shelldrop.sh/mcp/
- **Repository:** https://github.com/shelldrop-sh/agent-skills/tree/HEAD/mcp-server
- **MCP Registry name:** sh.shelldrop/shelldrop
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

This is documentation as a server. It answers from fixed text so an assistant can walk you through reaching a command-line agent such as Claude Code or Codex on a Mac or Linux machine from an iPhone or iPad. It never connects to or changes a machine, and the site says it is not an SSH MCP server.

Four tools: setup_guide covers enabling SSH, installing tmux and Tailscale, keeping the machine awake and adding a key; tmux_howto gives exact commands for attaching, detaching, scrolling and panes; generate_tmux_conf writes a phone-friendly ~/.tmux.conf with touch scrolling, OSC 52 copy and an optional Ctrl-a prefix; troubleshoot_connection covers timeouts, refusals and missing sessions.

It needs no account, key or login and keeps no logs of inputs. It runs on Cloudflare, and the code is open source. Shell Drop is the vendor's iOS terminal app, but the connector works with or without it.

## Features

- **Setup guide:** Step-by-step SSH, tmux and Tailscale setup.
- **tmux how-to:** Exact commands for common tasks.
- **Phone tmux config:** Generates a tmux.conf for touch use.
- **Connection fixes:** Troubleshoots common phone-to-machine errors.
- **Read-only:** Never touches your machines.
- **No login:** Authentication fields stay empty.

## Good for

- Set up a Mac mini to reach Claude Code from a phone
- Detach from tmux without stopping an agent
- Fix an SSH connection refused error
- Get a phone-friendly tmux config

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http shelldrop https://mcp.shelldrop.sh/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.shelldrop.sh/mcp
```

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

```json
{
  "mcpServers": {
    "shelldrop": {
      "url": "https://mcp.shelldrop.sh/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "shelldrop": {
      "type": "http",
      "url": "https://mcp.shelldrop.sh/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "shelldrop": {
      "serverUrl": "https://mcp.shelldrop.sh/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "shelldrop": {
      "type": "http",
      "url": "https://mcp.shelldrop.sh/mcp"
    }
  }
}
```

## Tools

- `setup_guide`: Step-by-step setup for macOS or Linux.
- `tmux_howto`: tmux commands for a task.
- `generate_tmux_conf`: Phone-friendly tmux config.
- `troubleshoot_connection`: Fixes for connection problems.

## FAQ

### Can it run commands on my machine?

No. Each tool returns text only.

### Do I need the Shell Drop app?

No. The connector works with or without it.

### What data does it keep?

Only tool arguments are received, with no database or input logging.

### Is Shell Drop free?

Yes. Shell Drop is free to use.

### How do I add Shell Drop to Claude Code?

Run this command in your terminal: claude mcp add --transport http shelldrop https://mcp.shelldrop.sh/mcp

### What are the best alternatives to Shell Drop?

The closest alternatives to Shell Drop 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/shell-drop
