MCP Catalogs
Home

applescript-mcp

by peakmojo·457·Score 51

MCP server for AppleScript execution on Mac, enabling AI control of system applications and files.

productivityfile-systemdeveloper-tools
58
Forks
3
Open issues
3 mo ago
Last commit
2d ago
Indexed

Overview

The AppleScript MCP server provides a straightforward way to interact with macOS applications and system functionality through AppleScript commands. With under 100 lines of core code, it offers minimal setup while providing powerful capabilities including access to Notes, Calendar, Contacts, Messages, Spotlight searches, file operations, and shell command execution. The server supports both local and remote execution via SSH, making it versatile for different use cases.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

you:Automating calendar events and reminders via AI
you:Reading and managing Notes and Messages applications
you:Executing file system operations and shell commands
you:What macOS applications can I control with this MCP server?
you:Can I use this MCP server from a Docker container?

When to choose this

Choose this when you need AI to control macOS applications and system functions through AppleScript execution, especially for productivity tasks like calendar management and file operations.

When NOT to choose this

Avoid if you need cross-platform support as this only works on macOS, or if you require more system-level access beyond what AppleScript provides.

Tools this server exposes

1 tool extracted from the README
  • execute_applescript

    Execute AppleScript code to interact with Mac applications and system functions

Comparable tools

shell-mcpmacos-mcpterminal-mcp

Installation

Installation

Node.js
{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}
Python (uvx)
{
  "mcpServers": {
    "applescript_execute": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/peakmojo/applescript-mcp",
        "mcp-server-applescript"
      ]
    }
  }
}
Python (local development)
  1. Clone the repository
git clone https://github.com/peakmojo/applescript-mcp.git
  1. Configure Claude Desktop
{
  "mcpServers": {
    "applescript_execute": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/repo",
        "run",
        "mcp-server-applescript"
      ]
    }
  }
}

FAQ

What macOS applications can I control with this MCP server?
You can control many native macOS applications including Notes, Calendar, Contacts, Messages, Finder, Spotlight, and Apple Music. You can also execute shell commands and read/write files.
Can I use this MCP server from a Docker container?
Yes, the server supports remote execution via SSH. You can configure it to connect to your Mac host using the 'host.docker.internal' hostname and proper SSH credentials.

Compare applescript-mcp with

GitHub →

Last updated · Auto-generated from public README + GitHub signals.