Simple bash command execution MCP server for Claude
If you want an AI assistant working directly with Bash MCP, the bash mcp mcp server is the bridge. Simple bash command execution MCP server for Claude.
A simple MCP (Model Context Protocol) server that enables Claude to execute shell commands without permission prompts.
The server is distributed via npm as npx, so most clients can run it without a manual build step. Add it to your MCP client's configuration and restart the client to pick it up — the copy-paste configs for Claude Desktop, Claude Code and Cursor are on this page.
The server reads 2 environment variables: BASH_MCP_MAX_OUTPUT_SIZE, BASH_MCP_TEMP_DIR. Keep credentials in your client's env block or a secrets manager rather than committing them.
File and storage servers are what separate an assistant that talks about your documents from one that actually works with them. Bash MCP sits in that group. Worth comparing against the other file systems servers in this directory before you commit to one, since several overlap in scope but differ sharply in setup cost and permissions.
{
"mcpServers": {
"bash": {
"command": "npx",
"args": ["bash-mcp"],
"env": {
"BASH_MCP_MAX_OUTPUT_SIZE": "102400",
"BASH_MCP_TEMP_DIR": "/tmp/bash-mcp-outputs"
}
}
}
}Configuration as documented by the project. Restart the client after saving.
| Variable | Description | Required |
|---|---|---|
| BASH_MCP_MAX_OUTPUT_SIZE | Configuration value read at startup. | Optional |
| BASH_MCP_TEMP_DIR | Filesystem location the server is allowed to use. | Optional |
Scoped local file access — read, write, search and reorganise files in directories you explicitly allow.
Search and read your Drive — Docs, Sheets and files become context your assistant can actually use.
Query, modify and analyse local SQLite databases in conversation — the fastest way to chat with a data file.
Build a programmable telecommunications stack for connecting telephony services with the Internet via a cloud-based utility.
Chat with your second brain — search, read and write vault notes through the Local REST API.
Connects AI models to an Obsidian knowledge base for direct access and manipulation of notes and folders.