Perm Shell MCP Server

MCP server for executing shell commands with permission notifications

Local serverstdio

What is the Perm Shell MCP MCP server?

Perm Shell MCP MCP server exists for a simple reason — assistants are far more useful when they can act on Perm Shell MCP directly instead of describing what you should do. MCP server for executing shell commands with permission notifications.

What you get

  • Execute shell commands with explicit permissions through growl notifications
  • Built on the Model Context Protocol for standardized LLM tools
  • Multiple safeguards to prevent unauthorized command execution
  • Transparent permission dialog shows exactly what commands will be executed

Setting it up

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.

Choosing this one

Among the AI and media services options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. It is maintained by mcollina; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the perm shell mcp mcp server does with a few real requests.

How to install the Perm Shell MCP MCP server

{
  "mcpServers": {
    "permshell": {
      "command": "node",
      "args": ["/path/to/perm-shell-mcp/dist/index.js"]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Frequently asked questions

It connects Perm Shell MCP to MCP-compatible AI assistants such as Claude and Cursor. Instead of copying data back and forth by hand, the assistant works with Perm Shell MCP directly.