Provides read-only access to macOS system information through native terminal utilities, including disk management, battery status, network configuration, and system profiler data.
macos-tools-mcp
FastMCP server that makes a handful of read-only macOS terminal utilities available to MCP clients.
Requirements
macOS 12 or newer (tools require native system binaries)
uv for dependency and virtual environment management
Python 3.11 (automatically managed by uv via
.python-version
)
Getting started
Install dependencies and create the virtual environment:
uv syncLaunch the MCP server:
uv run macos-tools-mcpThe FastMCP server starts with default settings and exposes the registered tools.
Available tools
diskutil_list
– lists disks and partitions by invokingdiskutil list
.battery_status
– reports battery information frompmset -g batt
.network_services
– enumerates configured network services vianetworksetup
.network_service_details
– retrieves IP/subnet/router info for a given network service (for exampleWi-Fi
).system_profile
– returns structured JSON fromsystem_profiler
; accepted aliases aresoftware
,hardware
,network
, andpower
.
Development notes
Execute
uv run python -m macos_tools_mcp.server
to run the server module directly.The helper module
macos_tools_mcp.tools
centralizes command invocation and validation logic if you need to add more tools.
local-only server
The server can only run on the client's local machine because it depends on local resources.
Provides read-only access to native macOS system utilities including disk management, battery status, network configuration, and system profiling through terminal commands. Enables users to retrieve system information and diagnostics from macOS machines via standardized MCP tools.