MCP server for AI-powered macOS control — apps, display, audio, files, screenshots, clipboard
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.
Project: /Users/apple/Aiwithdhruv/AI Development/Claude/Mac-Automation/
MCP Server: Mac-Automation/macos_mcp.py
get_system_info() # macOS version, chip, RAM, uptime
get_running_apps() # All visible running apps
get_disk_usage() # Storage per volume
open_app(app_name="Safari") # Launch app (validated against /Applications/)
close_app(app_name="Notes") # Graceful quit via AppleScript
switch_to_app(app_name="Terminal") # Bring to foreground
toggle_dark_mode() # Switch light <-> dark (instant visual)
set_volume(level=50) # 0-100, auto-unmutes
send_notification(title="Hey", message="Class starting!", sound="Glass")
play_sound(sound_name="Ping") # 14 system sounds available
spotlight_search(query="invoice.pdf", folder="~/Documents", limit=20)
open_folder(folder_path="~/Desktop") # Opens in Finder
get_clipboard() # Read current clipboard
set_clipboard(text="Hello World") # Write to clipboard
take_screenshot(region="full") # Saves PNG to Desktop
take_screenshot(region="window") # Front window only
| 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) |
| Name | Type | Description | |------|------|-------------| | result | str | Human-readable result or error message |
| Name | Type | Required | Description | |------|------|----------|-------------| | (none) | — | — | No credentials needed — uses local macOS commands |
ghost-browser — screenshot → analyze → automate browsergoogle-mcp — search files → email attachmentinstantly-campaigns — clipboard → email templatesFree — stdlib only, no API calls.
Edit PDFs with natural-language instructions using the nano-pdf CLI.
Control Sonos speakers (discover/status/play/volume/group).
Terminal Spotify playback/search via spogo (preferred) or spotify_player.
Capture frames or clips from RTSP/ONVIF cameras.
CLI to manage emails via IMAP/SMTP. Use `himalaya` to list, read, write, reply, forward, search, and organize emails from the terminal. Supports multiple accounts and message composition with MML (MIME Meta Language).
Monitor blogs and RSS/Atom feeds for updates using the blogwatcher CLI.
Category:tools