# Mac Shell

> Use this tool when you need to execute macOS terminal commands securely, with features like command whitelisting and approval workflows to prevent potentially dangerous operations. It solves problems related to secure terminal access and command management, providing a controlled interface for AI assistants to interact with the macOS terminal. Ideal for use cases requiring restricted command execution, Mac Shell takes input commands and outputs execution results, with a built-in security system to categorize and manage commands.

Canonical page: https://skillsregistry.net/skills/cfdude-mac-shell  
JSON: https://api.skillsregistry.net/v1/skills/cfdude-mac-shell

## Description

Mac Shell MCP Server enables secure execution of macOS terminal commands through ZSH shell with a built-in security system that categorizes commands as safe, requiring approval, or forbidden. It features a pre-configured whitelist of common commands, an approval workflow for potentially dangerous operations, and comprehensive command management tools. Written in TypeScript and designed to work with Roo Code and Claude Desktop, it can be installed locally or run via npx, making it ideal for AI assistants that need controlled access to the macOS terminal while maintaining security through command whitelisting and explicit approval mechanisms.

## Trust

- **Trust score (0–1):** 0.96
- **Verification tier:** verified
- **Last scanned:** 2026-09-19

## Facts

- **Version:** 1.0.0
- **Skill type:** atomic
- **Execution layer:** mcp-remote
- **Runtime environment:** api
- **Category:** security
- **Updated:** 2026-09-19

## Source

- **Source listing:** [PulseMCP](https://www.pulsemcp.com/servers/cfdude-mac-shell)
- **Repository:** <https://github.com/cfdude/mac-shell-mcp>

## Use it

Resolve this record through the SkillsRegistry MCP server (no auth, read-only):

```
claude mcp add --transport http --scope user skillsregistry https://api.skillsregistry.net/mcp
```

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_skill",
    "arguments": {
      "slug": "cfdude-mac-shell"
    }
  }
}
```

REST: `GET https://api.skillsregistry.net/v1/skills/cfdude-mac-shell` · pull for local use: `GET https://api.skillsregistry.net/v1/skills/cfdude-mac-shell/pull`

---
SkillsRegistry indexes agent skills from public registries and GitHub. Skills we have analysed are scanned with Circle-IR and scored on six dimensions; each listing states its scan coverage. More: https://skillsregistry.net/llms.txt