Coyote

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 Calculator
• Use 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-use server 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

References

• TypeScript MCP SDK
• MCP Protocol Overview
• Build an MCP Server