coyote-mcp-server

Sai-Adarsh/coyote-mcp-server

3.3

If you are the rightful owner of coyote-mcp-server 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.

The Coyote MCP Server is a versatile tool designed to facilitate communication between various clients and the Model Context Protocol (MCP) framework.

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 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

ClientSetup Command
Claude CLInpm run setup-claude-cli
Claude Desktopnpm run setup-claude
VS Codenpm run setup-vscode
Windsurfnpm run setup-windsurf
Cursornpm run setup-cursor
All clientsnpm 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