LocalFree

shell-use MCP server

kyuheon-kr/shell-use

Let agents use the shell like a human.

0 GitHub stars

Install shell-use in Claude Code

Claude Code
claude mcp add shell-use -e SHELL_USE_SESSIONS=... -- docker run -i --rm -e SHELL_USE_SESSIONS ghcr.io/kyuheon-kr/shell-use:1.0.0
mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)
{
  "mcpServers": {
    "shell-use": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "SHELL_USE_SESSIONS",
        "ghcr.io/kyuheon-kr/shell-use:1.0.0"
      ],
      "env": {
        "SHELL_USE_SESSIONS": "..."
      }
    }
  }
}

Replace each ... with your own value.

Frequently asked questions

What does the shell-use MCP server do?

Let agents use the shell like a human.

Is the shell-use MCP server free?

Yes, most likely. Open source and no paid account or API key is mentioned in the listing. Check the provider for current pricing.

Does shell-use run locally or remotely?

Local. Runs on your machine (stdio). You install it with npx, uvx, Docker or from source.

How do I add shell-use to Claude Code?

Run: claude mcp add shell-use -e SHELL_USE_SESSIONS=... -- docker run -i --rm -e SHELL_USE_SESSIONS ghcr.io/kyuheon-kr/shell-use:1.0.0

More ai agents & coding agents MCP servers

View all