Skip to main content
Glama
alexlock1

macOS MCP Server

by alexlock1

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
macos_pick_fileA

Open a file picker dialog and return the selected file path. Returns null if cancelled.

macos_pick_folderA

Open a folder picker dialog and return the selected folder path. Returns null if cancelled.

macos_pick_filesA

Open a file picker dialog allowing multiple selection. Returns array of paths or null if cancelled.

macos_save_dialogA

Open a save file dialog and return the chosen path. Returns null if cancelled.

macos_clipboard_readA

Read the current text content from the system clipboard.

macos_clipboard_writeB

Write text content to the system clipboard.

macos_notifyB

Display a macOS system notification.

macos_open_urlA

Open a URL in the default web browser.

macos_system_infoA

Get macOS system information: computer name, username, home directory, OS version.

macos_reveal_in_finderA

Reveal a file or folder in Finder and bring Finder to front.

macos_open_with_defaultC

Open a file with its default application.

macos_get_finder_selectionA

Get the currently selected files/folders in the frontmost Finder window.

macos_screenshotB

Take a screenshot and save to file. Can capture full screen, a region, or specific window.

macos_screenshot_clipboardB

Take a screenshot and copy to clipboard (interactive selection).

macos_screen_resolutionA

Get the current screen resolution and scale factor.

macos_image_infoB

Get image metadata: dimensions, format, color space, bit depth.

macos_image_resizeC

Resize an image. Specify width, height, or maxSize to maintain aspect ratio.

macos_image_convertC

Convert image to another format (jpeg, png, gif, tiff, bmp, heic).

macos_pdf_page_countB

Get the number of pages in a PDF file.

macos_pdf_mergeC

Merge multiple PDF files into one.

macos_quick_lookC

Open a file with Quick Look preview.

macos_note_createC

Create a new note in the Notes app.

macos_note_foldersB

List all folders in the Notes app.

macos_note_listC

List all notes in a folder.

macos_note_readC

Read the content of a note by its ID.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.5/5.0

Scored across 25 tools

Disambiguation5/5

Each tool has a clearly distinct purpose with no significant overlap. Tools are organized by functional domains like clipboard, images, notes, PDFs, file operations, and system utilities, making it easy for an agent to select the right tool. For example, macos_screenshot and macos_screenshot_clipboard serve different output destinations, and macos_pick_file, macos_pick_files, and macos_pick_folder handle distinct selection types.

Naming Consistency5/5

All tool names follow a consistent 'macos_' prefix with snake_case and a clear verb_noun pattern, such as macos_clipboard_read, macos_image_convert, and macos_note_list. This uniformity enhances readability and predictability, allowing agents to easily understand and navigate the toolset without confusion from mixed conventions.

Tool Count3/5

With 25 tools, the count is on the higher side for a macOS utility server, bordering on heavy. While it covers many common macOS operations comprehensively, it might feel overwhelming or redundant in some areas, such as multiple screenshot and file picker variants. A more streamlined set could improve usability without losing core functionality.

Completeness5/5

The toolset provides complete coverage for macOS automation tasks, including CRUD operations for notes, image and PDF manipulation, file system interactions, clipboard management, and system information. There are no obvious gaps; agents can perform end-to-end workflows like creating notes, processing images, and handling files without dead ends.

Maintenance

ActivityInactive
ResponsivenessNo issues