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

BetterBugs

The BetterBugs MCP (Model Context Protocol) enables you to load BetterBugs bug reports (via report links) directly to your preferred AI Agents and developer environments with MCP Client capabilities (such as Cursor, VS C

Hermoso

Hermoso is an AI marketing agent and AI ad generator you run from your AI agent: a remote MCP server that researches the ads already winning in your market, makes image and video ads and organic posts in your brand, publ

Mcp-Warden

ermoluk

Local-first credential broker for MCP. AI coding agents (Claude Code, Cursor, Codex…) call APIs, SSH and databases through scoped presets; secrets stay in your OS keychain and never enter the agent's context.

extentos

Asger mølgaard

Extentos is a multi-vendor development platform for adding smart-glasses capabilities to existing iOS and Android apps. The simplest analogy is Stripe for smart glasses:

OrangePro

Aamir Siddiqui

OrangePro local-first CLI + MCP server for behavior mapping, grounded test generation, and dynamic proof.