MCP server

shell-use

io.github.kyuheon-kr/shell-use

Checked 25 Oct 2026, 21:10 UTC · Checked against OSV.dev for malware and vulnerabilities; never run by us

Let agents use the shell like a human.

Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Runs on your computer

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code

Last checked

25 Oct 2026, 21:10 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. It then runs the package on your computer with your permissions. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

{"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":"YOUR_VALUE"}}}}

Codex (config.toml)

[mcp_servers.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 = "YOUR_VALUE" }

Gemini CLI

{"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":"YOUR_VALUE"}}}}

Cursor

{"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":"YOUR_VALUE"}}}}

VS Code

{"servers":{"shell-use":{"type":"stdio","command":"docker","args":["run","-i","--rm","-e","SHELL_USE_SESSIONS","ghcr.io/kyuheon-kr/shell-use:1.0.0"],"env":{"SHELL_USE_SESSIONS":"YOUR_VALUE"}}}}

Runs on your computer with your permissions: check the package and its source before installing. Replace YOUR_VALUE with your own SHELL_USE_SESSIONS.

Browse

• GitHub tools
• GitHub and code hosting

Related MCP servers

• PayRam
  Install, configure, operate and integrate self-hosted PayRam crypto payment gateways.
• No-Shell Agent Architect MCP
  Turns vague automation requests into tool stacks, prompts, QA checks, and human boundaries.
• Hookpulse
  Dead-man switch for cron and webhooks: ingest URL, miss detection, alerts and a status feed.
• Verdict L402
  Ask if an action is safe before your agent runs it: injection, shell, MCP installs. Free samples.
• Apuchat
  Real-time chat for AI agents. Claude Code, Cursor, Cline and Codex join channels over MCP.
• Draw me
  Public art experiment: draw Mehmet Sarıtaş as SVG, submit it, see the wall, vote for drawings.
• Day1work
  Human-and-agent marketplace: find work, post tasks, bid, chat, request payments.
• Cron Parser
  Cloudflare Workers MCP server: cron-parser

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.kyuheon-kr/shell-use.svg)](https://aptlynx.net/servers/io.github.kyuheon-kr/shell-use)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents