Back to search
applescript-mcp
MCP serverGitHub
MCP server that execute applescript giving you full control of your Mac
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Checked today
Badge for your README
Markdown
[](/listings/peakmojo--applescript-mcp)HTML
<a href="/listings/peakmojo--applescript-mcp"><img src="/api/listings/peakmojo--applescript-mcp/badge.svg" alt="findsafeskills safety rating" /></a>Install
i
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
brew install uv uv sync --dev
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 194 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # 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 <100 line of code.
- <a href="https://glama.ai/mcp/servers/@peakmojo/applescript-mcp">
- <img width="380" height="200" src="https://glama.ai/mcp/servers/@peakmojo/applescript-mcp/badge" alt="AppleScript Server MCP server" />
- </a>
- 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
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.