Let agents use the shell like a human.
Connect Runs on your machine
claude mcp add shell-use -e SHELL_USE_SESSIONS=<SHELL_USE_SESSIONS> -e SHELL_USE_SOCKET=<SHELL_USE_SOCKET> -- docker run -i --rm ghcr.io/kyuheon-kr/shell-use:1.0.0
{
"mcpServers": {
"shell-use": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/kyuheon-kr/shell-use:1.0.0"
],
"env": {
"SHELL_USE_SESSIONS": "<SHELL_USE_SESSIONS>",
"SHELL_USE_SOCKET": "<SHELL_USE_SOCKET>"
}
}
}
}
{
"mcpServers": {
"shell-use": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/kyuheon-kr/shell-use:1.0.0"
],
"env": {
"SHELL_USE_SESSIONS": "<SHELL_USE_SESSIONS>",
"SHELL_USE_SOCKET": "<SHELL_USE_SOCKET>"
}
}
}
}
{
"servers": {
"shell-use": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/kyuheon-kr/shell-use:1.0.0"
],
"env": {
"SHELL_USE_SESSIONS": "<SHELL_USE_SESSIONS>",
"SHELL_USE_SOCKET": "<SHELL_USE_SOCKET>"
}
}
}
}
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
SHELL_USE_SESSIONSRequired | Comma-separated list of allowed session names |
SHELL_USE_SOCKETOptional | Path to tmux socket (default: /tmux/tmux.sock in Docker) |
Details
| Package | ghcr.io/kyuheon-kr/shell-use:1.0.0 (OCI, stdio) |
| First published | 13 Jan 2026 |
| Last updated | 13 Jan 2026 |
| Registry name | io.github.kyuheon-kr/shell-use |
More developer tools servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
