Back to Home
homelab-admin icon

bettertouchtool-mcp-server

Verified Safe

by homelab-admin

Overview

Enables AI assistants like Claude to control and interact with BetterTouchTool on macOS for automation, configuration management, and system interaction.

Installation

Run Command
uv run btt_mcp.py

Security Notes

The server exposes powerful BetterTouchTool capabilities to an AI agent, including reading/writing arbitrary local file paths for preset management, displaying notifications with arbitrary images, and reading/writing clipboard content. While the server itself doesn't contain obvious injection vulnerabilities (inputs are Pydantic-validated), a compromised AI agent controlling this server could leverage these capabilities to perform destructive actions (e.g., overwrite system files via preset export), access sensitive user data (e.g., read clipboard contents), or exfiltrate local files if combined with other tools. The default communication is local HTTP, but passing a 'shared_secret' in a URL parameter is generally not ideal, though mitigated by default localhost operation. The `bttcli` subprocess execution appears robust against direct command injection from the MCP client.

Similar Servers

Stats

Interest Score0
Security Score6
Cost ClassMedium
Avg Tokens1000
Stars0
Forks0
Last Update2025-11-30

Tags

mcpbettertouchtoolmacosautomationclaude