mcp_server_mac_brightness
3.2
If you are the rightful owner of mcp_server_mac_brightness and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A Model Context Protocol server for controlling Mac screen brightness and system volume.
MCP Mac Brightness Server
A Model Context Protocol server for controlling Mac screen brightness and system volume.
Features
-
Screen Brightness Control
- Get current screen brightness
- Set screen brightness with optional fade duration
- Supports brightness range: 0-100%
-
System Volume Control
- Get current system volume
- Set system volume
- Toggle system mute state
Requirements
- Python >= 3.10
- macOS (uses native macOS frameworks)
- Required permissions for screen and audio control
- brightness (Install via Homebrew):
brew install brightness
Installation
uv pip install -e .
Usage
Start the Server
Available Tools
-
get_screen_brightness()
- Returns current screen brightness (0-100)
-
set_screen_brightness(brightness: float, duration: float = 0)
- Set screen brightness level
- brightness : Target brightness (0-100)
- duration : Fade duration in seconds (0 for immediate change)
-
get_system_volume()
- Returns current system volume (0-100)
-
set_system_volume(volume: int)
- Set system volume level (0-100)
-
toggle_system_mute()
- Toggle system audio mute state
Configuration
Configure in Claude desktop:
{
"mac_brightness": {
"command": "uvx",
"args": ["mcp-server-mac-brightness"]
}
}
Error Handling
- Input validation for brightness and volume levels
- Comprehensive error messages for system API failures
- Graceful error handling for permission issues
License
MIT License
