Claude MarketplacesSubmit
domdomegg avatar

Shell Exec

domdomegg/shell-exec-mcp

Gives Claude direct shell access through two tools: execute for running bash commands with optional timeouts and background mode, and get_job_status for checking on long-running jobs. Reach for this when you need Claude to handle build scripts, file operations like find and grep, or system inspection commands. The background job support means you can start a dev server or watch process, then query its status later without blocking. Ships with both stdio and HTTP transports, so you can run it locally via npx or host it as a service. The usual warnings apply: this executes arbitrary commands on your system, so think carefully about where you deploy it.

GitHub stars
5
tools
2
auth
Required
transport
STDIO, HTTP
env var
1
last updated
May 3, 2026
View on GitHub

Tools

2 tools

Public tool metadata for what this MCP can expose to an agent.

executeRun a bash command (with optional timeout and background mode)

Run a bash command (with optional timeout and background mode)

No parameter schema in public metadata yet.

get_job_statusCheck status of a background job

Check status of a background job

No parameter schema in public metadata yet.

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Configuration

MCP_TRANSPORT*

Transport type.

Readme

shell-exec-mcp

MCP server for executing bash commands with background job support.

Use Cases

Run build commands: Execute npm run build, make, or other build tools and get the output.

File operations: Use find, grep, mv, rm, mkdir -p, stat etc. for file management.

Long-running tasks: Start servers or watch processes in background mode, check on them later.

System info: Run df -h, ps aux, env etc. to inspect the system state.

Setup

Follow the instructions on install-mcp, which generates the right config for your MCP client (Claude Code, Claude Desktop, Cursor, Cline, VS Code, and more).

Tools

ToolDescription
executeRun a bash command (with optional timeout and background mode)
get_job_statusCheck status of a background job

Contributing

Pull requests are welcomed on GitHub! To get started:

View the full README on GitHub

Details

Repository
github.com/domdomegg/shell-exec-mcp
Website
github.com/domdomegg/shell-exec-mcp#readme
Category
Developer Tools
Package
shell-exec-mcp
Transport
STDIO, HTTP
Auth
Required
Registry
MCP registry, active

More from domdomegg

Related Developer Tools MCP servers

View all
1oncorporation avatarFileSystem MCP Serveroncorporation/filesystem_serverSecure filesystem access for AI agents with configurable directory and file type restrictions5stars
2crypto-ninja avatarGithub Mcp Servercrypto-ninja/mcp-server-for-githubAI-optimized GitHub MCP server: 112 tools, 98% token reduction, compact responses.0stars
3detailobsessed avatarEfficient Gitlabdetailobsessed/efficient-gitlab-mcpToken-efficient GitLab MCP: 167 tools via 3 meta-tools, field projection, keyset pagination3stars
4ofershap avatarGithub Actionsofershap/mcp-server-github-actionsGitHub Actions MCP — view runs, read logs, re-run jobs, and manage CI/CD.3stars
5ozanmutlu avatarGitlab Docsozanmutlu/gitlab-docs-mcpSearch and browse 2,900+ official GitLab documentation pages via MCP3stars
6lawp09 avatarBitbucket MCP Serverlawp09/bitbucket-mcpMCP server for Bitbucket API - manage repositories, pull requests, comments, pipelines and more3stars