macOS Tools MCP Server
Provides read-only access to macOS system information through native terminal utilities, including disk management, battery status, network configuration, and system profiler data.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@macOS Tools MCP Server show me my battery status"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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)
Related MCP server: mcp-system-info
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.serverto run the server module directly.The helper module
macos_tools_mcp.toolscentralizes command invocation and validation logic if you need to add more tools.
Available Tools
5 toolsbattery_statusB
Show current battery information reported by pmset -g batt.
Inputs: no named parameters. Returns: result
diskutil_listB
List all disks and partitions using diskutil list.
Inputs: no named parameters. Returns: result
network_service_detailsB
Retrieve interface details (IP, subnet, router) for a network service.
Inputs: service_name (required). Returns: result
network_servicesA
List configured network services as reported by networksetup.
Inputs: no named parameters. Returns: result
system_profileC
Return structured data from system_profiler for the requested data type.
Inputs: data_type. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool has a clearly distinct purpose targeting different macOS system components: battery, disks, network services (listing vs. details), and system profile. There is no overlap in functionality, making tool selection straightforward for an agent.
The naming follows a consistent snake_case pattern with descriptive names (e.g., battery_status, diskutil_list). However, there is a minor deviation with 'network_service_details' and 'network_services' using slightly different naming styles (details vs. services) compared to the others, though still readable.
With 5 tools, the count is well-scoped for a macOS system utilities server. Each tool serves a specific, non-trivial purpose (battery, disks, network, system info), and there are no redundant or missing tools that would make the set feel too thin or bloated.
The toolset covers key macOS system areas (battery, storage, network, hardware/software info), but there are notable gaps in common system operations like process management, file operations, or user management. While the provided tools are useful, the surface is incomplete for broader system administration tasks.
Related MCP Connectors
Read-only MCP access to a documented IT fleet: state, changes, posture. 15 tools.
Read-only developer, date, finance, and text utilities. Authless remote MCP server by Clean.tools.
Read-only MCP tools for AI agent discovery, structured resources, and NIULAI information.
MCP connector that lets ChatGPT list, search, and run your Apple Shortcuts via a local Mac agent
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceProvides comprehensive macOS, Linux, and Windows system administration, diagnostics, and optimization tools including network inspection, security scanning, compliance auditing, database diagnostics, and structured DevOps task planning.-
- AlicenseAqualityDmaintenanceProvides system hardware information (CPU, memory, storage, etc.) and system status (OS, network, resource usage) via MCP tools.210 npmISC
- AlicenseAqualityBmaintenanceAn MCP server that exposes macOS-native device trust signals — the facts about a Mac that cannot be gathered from a Linux container or a cloud runner. All tools are strictly read-only.22MIT
- FlicenseAqualityCmaintenanceEnables an MCP client such as Claude to inspect a Mac's battery, memory, CPU, GPU, disk, and most energy-hungry apps, and to shut down, restart, sleep, or lock the screen now or on a schedule with a cancellable 60-second grace period.14-