# JCAppleScript

Give an AI agent access to macOS apps through AppleScript and predefined commands. Useful for tasks in Finder, Mail, Messages, and other apps.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 28
- Author: johnnyclem
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/johnnyclem/JCAppleScript
- Updated: 2026-08-29
- HTML: https://affpapa.org/en/nevibecode/mcp/jcapplescript

## What it does

JCAppleScript exposes commands for Messages, Mail, Reminders, Calendar, Notes, Finder, Safari, Music, Terminal, System Settings, Xcode, and Speech Recognition. An agent can search the command registry and inspect the script a command will run. Developers can add commands for other apps by implementing the `ScriptableApp` protocol.

Build the server with `swift build -c release`; the executable is created at `.build/release/jcas-mcp`. To connect it to Claude Desktop, add the executable’s path to `claude_desktop_config.json`. Safe mode disables tools that run arbitrary AppleScript or JXA, along with commands marked `dangerous`. Only the ready-made safe commands remain available.

## Requirements
- Environment variables: `JCAS_SAFE_MODE`, `JCAS_APP_MANIFESTS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- Send a message through Messages
- Search Mail and draft a reply
- Create an event in Calendar
- Open or build an Xcode project
- Inspect a Finder folder

## Example prompts
- Send John a Messages note saying I’ll be late.
- Find emails about the release in Mail and draft a reply.
- Open the project in Xcode and run its tests.

## Similar
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [AIHawk](https://affpapa.org/en/nevibecode/mcp/aihawk.md) — MCP server · ★ 32221
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23263
- [SeleniumBase MCP](https://affpapa.org/en/nevibecode/mcp/seleniumbase-mcp.md) — MCP server · ★ 13169
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12791

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md