Let agents use the shell like a human.
{
"SHELL_USE_SESSIONS": "YOUR_VALUE_HERE",
"SHELL_USE_SOCKET": "YOUR_VALUE_HERE"
}Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
{
"mcpServers": {
"io-github-kyuheon-kr-shell-use": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-io-github-kyuheon-kr-shell-use"
],
"env": {
"SHELL_USE_SESSIONS": "YOUR_VALUE_HERE",
"SHELL_USE_SOCKET": "YOUR_VALUE_HERE"
}
}
}
}~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.jsonNo remote HTTP endpoint is advertised. Use the package or stdio setup shown in Install.
shell-use is an MCP server for Let agents use the shell like a human.. It supports STDIO transport.
Use the client-specific config in Install and add it to your MCP-compatible client.
Choose the Claude Desktop tab in Install and copy the config into Claude Desktop's MCP server settings.
Choose the Claude Code tab in Install and copy the config into Claude Code's MCP server settings.
Choose the Codex tab in Install and copy the config into Codex's MCP server settings.
Choose the Cursor or VS Code tab in Install and copy the config into Cursor or VS Code's MCP server settings.
shell-use uses STDIO transport. Use the package or command config in Install.
shell-use inventory is listed when the MCP endpoint exposes tools, resources, or prompts. Some servers require auth first.
shell-use is marked with Auth required by registry metadata auth. You may need provider login, an API key, a bearer token, or a session header.
| Package | Registry | Version | Inputs |
|---|---|---|---|
ghcr.io/kyuheon-kr/shell-use:1.0.0stdio | oci | Not captured | Env: SHELL_USE_SESSIONS required Env: SHELL_USE_SOCKET |