Skip to main content
Glama
macOS Tools MCP Server

macOS Tools MCP Server

by Zhuoli

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

  1. Install dependencies and create the virtual environment:

    uv sync
  2. Launch the MCP server:

    uv run macos-tools-mcp

    The FastMCP server starts with default settings and exposes the registered tools.

Available tools

  • diskutil_list – lists disks and partitions by invoking diskutil list.

  • battery_status – reports battery information from pmset -g batt.

  • network_services – enumerates configured network services via networksetup.

  • network_service_details – retrieves IP/subnet/router info for a given network service (for example Wi-Fi).

  • system_profile – returns structured JSON from system_profiler; accepted aliases are software, hardware, network, and power.

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.

Available Tools

5 tools
battery_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

    A3.5/5.0

    Scored across 5 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness3/5

    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

    Related MCP Servers

    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Provides 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.
      -
    • A
      license
      A
      quality
      D
      maintenance
      Provides system hardware information (CPU, memory, storage, etc.) and system status (OS, network, resource usage) via MCP tools.
      2
      10 npm
      ISC
    • A
      license
      A
      quality
      B
      maintenance
      An 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.
      22
      MIT
    • F
      license
      A
      quality
      C
      maintenance
      Enables 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
      -