# JCAppleScript MCP server

> Lets AI assistants control macOS applications through AppleScript, JXA, and pre-built command shortcuts for apps like Messages, Mail, and Finder.

- Repository: https://github.com/johnnyclem/JCAppleScript
- Page: https://hostedmcp.org/servers/johnnyclem/jcapplescript
- Transport: stdio
- Stars: 28
- License: MIT
- Latest version: 2.0.0

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `JCAS_APP_MANIFESTS` | no | no | Colon-separated list of JSON manifest files with additional community app definitions to load at startup. |
| `JCAS_SAFE_MODE` | no | no | Set to 1 to disable tools that execute arbitrary code (execute_applescript, execute_jxa, tell_application) and registry commands flagged dangerous. |

## Tools (10)

- `execute_applescript`
- `execute_jxa`
- `tell_application`
- `check_script_syntax`
- `list_running_applications`
- `list_registered_apps`
- `search_commands`
- `run_app_command`
- `preview_app_command`
- `get_app_commands`

## FAQ

### How can I make the server more secure?

You can enable safe mode by setting the JCAS_SAFE_MODE environment variable to 1, which disables arbitrary code execution tools and dangerous registry commands.

### Which macOS apps are supported out of the box?

The server includes built-in command sheets for 12 apps, including Messages, Mail, Reminders, Calendar, Notes, Finder, Safari, Music, Terminal, System Settings, Xcode, and Speech Recognition.

### Can I add my own applications to the registry?

Yes, you can add support for any scriptable macOS app by implementing the ScriptableApp protocol.

### How do I install this on Claude Desktop?

You can install it by adding the server to your Claude Desktop configuration file located at ~/Library/Application Support/Claude/claude_desktop_config.json.