Mac Shell MCP Server

@cfdude

Basic information

About Mac Shell MCP Server

An MCP (Model Context Protocol) server for executing macOS terminal commands with ZSH shell. This server provides a secure way to execute shell commands with built-in whitelisting and approval mechanisms.

#zsh #mac #mcp

Mac Shell MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mac-shell-mcp": {
      "command": "node",
      "args": [
        "build/index.js"
      ]
    }
  }
}

Mac Shell MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Mac Shell MCP Server?

Mac Shell MCP Server is an MCP (Model Context Protocol) server for executing macOS terminal commands with ZSH shell. It provides a secure way to run shell commands with built-in whitelisting and approval mechanisms, designed for AI assistants like Roo Code and Claude Desktop.

How to use Mac Shell MCP Server?

Install by cloning the repository and running npm install && npm build, or use npx directly from the GitHub repository. Configure the server in your MCP client settings (Roo Code or Claude Desktop), then invoke tools such as execute_command or get_whitelist to run and manage shell commands.

Key features of Mac Shell MCP Server

Execute macOS terminal commands through MCP
Three security levels: safe, requires approval, forbidden
Pre-configured whitelist with common safe commands
Approval workflow for potentially dangerous commands
Tools to manage whitelist and pending approvals

Use cases of Mac Shell MCP Server

AI-assisted file browsing and directory listing
Safe execution of read-only commands (ls, cat, grep)
Controlled file operations with approval (cp, mv, mkdir)
Blocking dangerous commands like rm and sudo

Frequently asked questions

What commands are safe by default?

Safe commands include ls, pwd, echo, cat, grep, find, cd, head, tail, and wc. These execute without approval.

What commands require approval?

Commands like mv, cp, mkdir, touch, chmod, and chown require explicit approval before execution.

Comments

More Developer Tools MCP servers

Yocoolab

MCP server for AI Agents — exposes Yocoolab feedback threads and design selections as tools

OSIR Domain Name MCP Server

Osir

Remote MCP server from OSIR, an ICANN-accredited registrar: 105 tools and 11 prompts to search, register, renew, transfer, and manage domains, DNS, VPS, email, and websites from Claude, ChatGPT, Cursor, or any MCP client

nohumans.directory

Find paid x402 APIs and check them before your agent pays. Every listing is probed for a live payment request, and many are bought with real USDC to show whether they deliver. Free, read-only, no sign-up.

Foremerge

naw103

Catch intent conflicts before code conflicts. The open-source coordination protocol for coding agents, built above Git.

SecondSim

econdSim provisions real UK mobile numbers (non-VoIP) via eSIM, built for freelancers, sole traders, small businesses, and enterprise teams. Unlike VoIP apps and virtual numbers, SecondSim numbers register as genuine phy