macOS Internal Tools

A Model Context Protocol server that brings macOS system tools directly inside your LLM client. Monitor system performance in real-time, analyze resource usage, search files with advanced patterns, and manage file tags using native macOS APIs.

typescript

GitHub Stars

typescript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "tornikegomareli-macos-tools-mcp-server": {
      "command": "npx",
      "args": [
        "@tgomareli/macos-tools-mcp"
      ]
    }
  }
}

You have access to a dedicated MCP server for macOS tools that provides real-time system monitoring and deep file search capabilities. By running this server through your MCP client, you can observe resource usage, analyze running processes, perform historical performance reviews, and perform advanced file searches with tagging and content analysis.

How to use

You use this MCP server by connecting through your MCP client. Once connected, you can run the available tools to monitor system performance and perform enhanced file searches. The system_performance tool gives you current metrics, historical history, and optimization suggestions, while enhanced_search lets you search file contents, filenames, and manage tags. Use these tools to gather insights, diagnose bottlenecks, and organize important files with custom tags.

How to install

Prerequisites you must have before installing: a macOS 10.15 or later system, Node.js 18.0.0 or later, and npm or yarn.

If you want to configure Claude Desktop to run this MCP server, add the following MCP server entry to your Claude Desktop configuration:

{
  "mcpServers": {
    "macos-tools": {
      "command": "npx",
      "args": [
        "@tgomareli/macos-tools-mcp"
      ],
      "env": {}
    }
  }
}

Additional installation steps

If you already have other MCP servers configured, you can merge the macos-tools entry into your existing mcpServers object.

{
  "mcpServers": {
    "existing-server": {
      // ... existing configuration
    },
    "macos-tools": {
      "command": "npx",
      "args": [
        "@tgomareli/macos-tools-mcp"
      ],
      "env": {}
    }
  }
}

Install via MCP Installer

If you prefer not to edit configuration files directly, you can install the MCP server using the MCP Installer prompt.

In Claude, request installation with the following prompt:

Hey Claude, install the MCP server named macos-tools-mcp

Available tools

system_performance

Monitor and analyze system performance metrics including current usage, historical trends, and optimization suggestions.

enhanced_search

Advanced file search with content analysis, tagging, and metadata-based queries.

Built by

VeilStrat

AI signals for GTM teams