# Applescript Mcp

> MCP server that execute applescript giving you full control of your Mac

- **Type:** MCP server
- **Install:** `agentstack add mcp-peakmojo-applescript-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [peakmojo](https://agentstack.voostack.com/s/peakmojo)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [peakmojo](https://github.com/peakmojo)
- **Source:** https://github.com/peakmojo/applescript-mcp

## Install

```sh
agentstack add mcp-peakmojo-applescript-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# AppleScript MCP Server (Dual access: python and node.js)

[](https://www.npmjs.com/package/@peakmojo/applescript-mcp) [](https://opensource.org/licenses/MIT)

## Overview

A Model Context Protocol (MCP) server that lets you run AppleScript code to interact with Mac. This MCP is intentionally designed to be simple, straightforward, intuitive, and require minimal setup.

I can't believe how simple and powerful it is. The core code is 
  

https://github.com/user-attachments/assets/b85e63ba-fb26-4918-8e6d-2377254ee388

## Features

* Run AppleScript to access Mac applications and data
* Interact with Notes, Calendar, Contacts, Messages, and more
* Search for files using Spotlight or Finder
* Read/write file contents and execute shell commands
* Remote execution support via SSH

## Example Prompts

```
Create a reminder for me to call John tomorrow at 10am
```

```
Add a new meeting to my calendar for Friday from 2-3pm titled "Team Review"
```

```
Create a new note titled "Meeting Minutes" with today's date
```

```
Show me all files in my Downloads folder from the past week
```

```
What's my current battery percentage?
```

```
Show me the most recent unread emails in my inbox
```

```
List all the currently running applications on my Mac
```

```
Play my "Focus" playlist in Apple Music
```

```
Take a screenshot of my entire screen and save it to my Desktop
```

```
Find John Smith in my contacts and show me his phone number
```

```
Create a folder on my Desktop named "Project Files"
```

```
Open Safari and navigate to apple.com
```

```
Tell me how much free space I have on my main drive
```

```
List all my upcoming calendar events for this week
```

## Usage with Claude Desktop

### Node.js
```json
{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp"
      ]
    }
  }
}
```

### Python (uvx)

No clone needed — run directly from the git repo:

```json
{
  "mcpServers": {
    "applescript_execute": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/peakmojo/applescript-mcp",
        "mcp-server-applescript"
      ]
    }
  }
}
```

### Python (local development)

For local development, clone the repo and use `uv` to run from source:

```
brew install uv
git clone https://github.com/peakmojo/applescript-mcp.git
```

```json
{
  "mcpServers": {
    "applescript_execute": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/repo",
        "run",
        "mcp-server-applescript"
      ]
    }
  }
}
```

## Development

### Setup

```bash
brew install uv
uv sync --dev
```

### Run all checks (in parallel)

```bash
uv run check
```

This runs linting, formatting, type checking, and tests with 100% coverage — all in parallel.

### Individual commands

```bash
uv run lint        # ruff linter
uv run format      # ruff auto-format
uv run typecheck   # pyrefly type checker
uv run test        # pytest with 100% coverage enforcement
```

## Docker Usage

When running in a Docker container, you can use the special hostname `host.docker.internal` to connect to your Mac host:

### Configuration
```json
{
  "mcpServers": {
    "applescript_execute": {
      "command": "npx",
      "args": [
        "@peakmojo/applescript-mcp",
        "--remoteHost", "host.docker.internal",
        "--remoteUser", "yourusername",
        "--remotePassword", "yourpassword"
      ]
    }
  }
}
```

This allows your Docker container to execute AppleScript on the Mac host system. Make sure:

1. SSH is enabled on your Mac (System Settings → Sharing → Remote Login)
2. Your user has proper permissions
3. The correct credentials are provided in the config

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [peakmojo](https://github.com/peakmojo)
- **Source:** [peakmojo/applescript-mcp](https://github.com/peakmojo/applescript-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-peakmojo-applescript-mcp
- Seller: https://agentstack.voostack.com/s/peakmojo
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.