mac-use
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 | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| mac_use_statusA | Report platform, Accessibility / Screen Recording, and Mac Use readiness. |
| get_screen_sizeA | Return main display width/height in screen points (origin top-left). Same space as screenshot and click. |
| screenshotA | Capture the main display as PNG. Image pixels match screen points — click those coordinates. |
| mouse_moveA | Move the cursor. Absolute: x and y (global points, origin top-left). Relative: dx and/or dy. Returns position and display size. |
| clickB | HID click at screen points (x, y), or at the current cursor if x/y omitted. Same coordinates as the screenshot. |
| mouse_dragA | Left-button HID drag from (fromX, fromY) to (toX, toY) in screen points. |
| type_textA | Type unicode into the focused app (HID). Click the field first. No clipboard. For shortcuts use key. |
| keyB | Key event to the focused app. direction press (default), down, or up. Destructive chords (cmd+q, cmd+w, cmd+delete) require confirmed=true. |
| scrollB | HID scroll wheel at (x, y). dy>0 scrolls down. Optional dx. |
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 9 tools
Each tool serves a distinct purpose: status, screen info, capture, cursor movement, clicking, dragging, typing, key events, and scrolling. There is no overlap in function; even mouse_move and click are clearly separated by action type.
Most tools follow a verb_noun pattern like get_screen_size, mouse_move, type_text, but a few are single verbs (click, key, scroll) or nouns (screenshot, mac_use_status). All use consistent snake_case, so the minor deviations are acceptable.
Nine tools is a well-scoped set for GUI automation on macOS, covering the essential input and display actions without redundancy. The count is within the ideal 3-15 range and each tool earns its place.
The set provides comprehensive coverage of mouse, keyboard, screen capture, and status checking. Minor gaps include no explicit right-click or double-click, and no clipboard interaction (though type_text covers typing), but these are workable limitations.