macOS MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
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
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 25 tools
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.
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.
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.
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.