Heimdall

The all-seeing guardian for macOS: Battery, Clipboard, TTS, and File System control using Claude desktop

GitHub

🛡️ Heimdall MCP Server ⚔️

MCP macOS Bun License

"The all-seeing guardian of the Bifröst."

Heimdall bridges Claude Desktop and your macOS system, giving AI the power to monitor hardware, control applications, and interact with your workflow.

✨ Features

FeatureDescription
👁️ VisionTake screenshots and see your screen
👂 VoiceText-to-speech for audio feedback
🔋 MonitoringBattery, CPU, and RAM metrics
💻 System InfoOS details, CPU specs, hostname
📋 ClipboardRead and write clipboard content
📂 FilesSave files directly to Desktop
🚀 App ControlLaunch, quit, and list applications

🚀 Quick Start

Clone and install

git clone https://github.com/sarva-20/heimdall-mcp.git cd heimdall-mcp bun install

Configure (see Installation Guide)

open -e ~/Library/Application\ Support/Claude/claude_desktop_config.json

Full setup guide: 📖 Installation

📚 Documentation

  • Installation Guide - Complete setup instructions
  • Usage Guide - Examples and commands
  • Troubleshooting - Common issues and fixes
  • Contributing - How to contribute

🎯 Example Usage

"Check my battery levels"
"Launch Spotify"
"What apps are running?"
"Read my clipboard and explain the error"
"Save this code to my desktop as script.py"

🛠️ Available Tools

System Monitoring

  • get_battery - Battery status with time remaining
  • get_cpu_load - Current CPU usage
  • get_memory_usage - RAM usage with percentage
  • get_system_info - OS, CPU, and hostname

System Actions

  • speak_message - Text-to-speech output
  • take_screenshot - Capture screen (requires permission)

Clipboard & Files

  • read_clipboard - Read clipboard content
  • write_to_clipboard - Copy text to clipboard
  • save_to_desktop - Save files to Desktop

Application Control

  • launch_application - Open macOS apps
  • quit_application - Close running apps
  • list_running_apps - List all running apps

🧰 Requirements

  • macOS (Apple Silicon or Intel)
  • Bun runtime (Install)
  • Claude Desktop (Download)

📜 License

MIT License - see LICENSE for details.

🙏 Acknowledgments

Built with the Model Context Protocol by Anthropic.

🛡️ Heimdall is now watching over your system. ⚔️

Made with ❤️ by Sarvatarshan Sankar

Report Bug • Request Feature

Related Servers