Back to Shell Drop

Shell Drop MCP connector

Free. Read-only. No account.

A remote MCP server that gives Claude and other AI tools step-by-step help for running AI coding agents on a Mac or Linux machine and reaching them from an iPhone or iPad: SSH, tmux, Tailscale and fixing connections. It is for anyone setting up Claude Code, Codex or another command-line agent to check on from their phone, with or without the Shell Drop app.

Endpoint

https://mcp.shelldrop.sh/mcp

Streamable HTTP, no login.

Add it

Claude (web and desktop)

In Settings, open Connectors, choose to add a custom connector, give it a name such as Shell Drop and paste the endpoint URL. Leave the authentication fields empty.

Claude Code

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

Cursor

Add this to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):

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

Any other client that speaks Streamable HTTP MCP can use the same URL.

Tools

Setup guide setup_guide

A step-by-step guide for macOS or Linux: turn on SSH, install tmux and Tailscale, keep the machine awake, add an SSH key and check it all works.

Try: "Set up my Mac mini so I can check on Claude Code from my iPhone."

tmux how-to tmux_howto

The exact tmux commands for a task: attach, detach, list, kill, scroll back, mouse, copy, rename, new sessions, windows and panes.

Try: "How do I detach from tmux without stopping my agent?"

Generate tmux.conf generate_tmux_conf

A phone-friendly ~/.tmux.conf (session names as terminal titles, touch scrolling, copy to the phone over OSC 52, long scrollback, optional Ctrl-a prefix) and how to apply it.

Try: "Write me a tmux.conf for using tmux from my phone, with Ctrl-a as the prefix."

Troubleshoot connection troubleshoot_connection

Fixes for common problems between a phone and a machine: connection timed out, connection refused, tmux "can't find session", copy from tmux not reaching the phone.

Try: "My SSH connection from my iPhone says connection refused. What do I check?"

What it can and can't do

Support

Questions or problems: [email protected]. The server is open source at github.com/shelldrop-sh/agent-skills. For the full walkthrough without an AI client, see the tmux cheat sheet and Claude Code on iPhone.


Shell Drop is a terminal for iPhone, iPad and iPhone Duo, built for running AI agents over SSH and tmux.

Download on the App Store