Coyote MCP Server
A Model Context Protocol (MCP) server that enables AppleScript execution on macOS through the run_applescript tool.
Quick Start
git clone https://github.com/Sai-Adarsh/coyote-mcp-server.git
cd coyote-mcp-server
npm install
npm run build
npm run setup-claude-cli # or setup-claude, setup-vscode, setup-windsurf, setup-cursor
Usage Commands
Interactive Mode (Recommended):
claude --mcp-config ~/.config/claude-cli/mcp.json
Then type any command like:
Use AppleScript to show a dialog with 'Hello World'Use AppleScript to open CalculatorUse AppleScript to open Safari and go to google.com
Quick Commands:
# Test the setup
claude --mcp-config ~/.config/claude-cli/mcp.json --print "Use AppleScript to show a dialog with 'Hello World'"
# Open applications
claude --mcp-config ~/.config/claude-cli/mcp.json --print "Use AppleScript to open Calculator"
claude --mcp-config ~/.config/claude-cli/mcp.json --print "Use AppleScript to open Safari"
# Navigate websites
claude --mcp-config ~/.config/claude-cli/mcp.json --print "Use AppleScript to open Safari and go to google.com"
# Create notifications
claude --mcp-config ~/.config/claude-cli/mcp.json --print "Use AppleScript to show a notification with title 'Test' and message 'Hello from MCP'"
Note: Claude CLI will ask for permission before executing AppleScript commands. Grant permission when prompted to allow automation.
Quick Setup Commands
| Client | Setup Command |
|---|---|
| Claude CLI | npm run setup-claude-cli |
| Claude Desktop | npm run setup-claude |
| VS Code | npm run setup-vscode |
| Windsurf | npm run setup-windsurf |
| Cursor | npm run setup-cursor |
| All clients | npm run setup-all |
After Setup
Once setup is complete, you'll see the MCP server listed as coyote-use in your client:
- Claude CLI/Desktop: Server appears in MCP configuration
- VS Code: Available in MCP extension as
coyote-use - Windsurf: Available in Cascade → Plugins as
coyote-use - Cursor: Server appears in MCP configuration as
coyote-use
The server provides the run_applescript tool for executing AppleScript commands on macOS.
Uninstall
To completely remove Coyote MCP Server and all configurations:
npm run uninstall
# or
./uninstall.sh
This will:
- Remove
coyote-useserver from all MCP client configurations - Uninstall the global npm package
- Clean up binary files from system PATH
- Create backup copies of modified configurations
- Clean npm cache and old backup files
Troubleshooting
Command not found error after update:
hash -r
Development
npm run build # Build the server
npm start # Start manually for testing