| name | mac-control |
| description | MCP server for AI-powered macOS control — apps, display, audio, files, screenshots, clipboard |
macOS Control — AI Mac Automation
Give Claude direct control of your Mac through 15 MCP tools. Open apps, toggle dark mode, search files, take screenshots, manage clipboard — all via natural language.
Location
Project: /Users/apple/Aiwithdhruv/AI Development/Claude/Mac-Automation/
MCP Server: Mac-Automation/macos_mcp.py
Tools Reference
System (read-only)
get_system_info()
get_running_apps()
get_disk_usage()
App Control
open_app(app_name="Safari")
close_app(app_name="Notes")
switch_to_app(app_name="Terminal")
Display & Audio
toggle_dark_mode()
set_volume(level=50)
Notifications
send_notification(title="Hey", message="Class starting!", sound="Glass")
play_sound(sound_name="Ping")
Files & Search
spotlight_search(query="invoice.pdf", folder="~/Documents", limit=20)
open_folder(folder_path="~/Desktop")
Clipboard
get_clipboard()
set_clipboard(text="Hello World")
Screenshot
take_screenshot(region="full")
take_screenshot(region="window")
Schema
Inputs
| Name | Type | Required | Description |
|---|
| app_name | str | varies | App name without .app (e.g., 'Safari') |
| level | int | varies | Volume 0-100 |
| title | str | varies | Notification title |
| message | str | varies | Notification body |
| sound | str | no | Sound name (default/Glass/Ping/Pop/etc.) |
| query | str | varies | Spotlight search query |
| folder | str | no | Folder to scope search |
| text | str | varies | Text for clipboard |
| region | str | no | Screenshot region (full/window) |
Outputs
| Name | Type | Description |
|---|
| result | str | Human-readable result or error message |
Credentials
| Name | Type | Required | Description |
|---|
| (none) | — | — | No credentials needed — uses local macOS commands |
Composable With
ghost-browser — screenshot → analyze → automate browser
google-mcp — search files → email attachment
instantly-campaigns — clipboard → email templates
Cost
Free — stdlib only, no API calls.
Safety
- Blocked keywords: rm, sudo, shutdown, format, erase, passwd, kill
- App names validated against /Applications/
- AppleScript strings sanitized
- 10s timeout on all commands
- No shell=True anywhere