Labsco
peakmojo logo

AppleScript MCP

β˜… 461

from peakmojo

Execute AppleScript to gain full control of your Mac.

πŸ”₯πŸ”₯πŸ”₯πŸ”₯βœ“ VerifiedFreeAdvanced setup

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

npm version License: 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

Copy & paste β€” that's it
Create a reminder for me to call John tomorrow at 10am
Copy & paste β€” that's it
Add a new meeting to my calendar for Friday from 2-3pm titled "Team Review"
Copy & paste β€” that's it
Create a new note titled "Meeting Minutes" with today's date
Copy & paste β€” that's it
Show me all files in my Downloads folder from the past week
Copy & paste β€” that's it
What's my current battery percentage?
Copy & paste β€” that's it
Show me the most recent unread emails in my inbox
Copy & paste β€” that's it
List all the currently running applications on my Mac
Copy & paste β€” that's it
Play my "Focus" playlist in Apple Music
Copy & paste β€” that's it
Take a screenshot of my entire screen and save it to my Desktop
Copy & paste β€” that's it
Find John Smith in my contacts and show me his phone number
Copy & paste β€” that's it
Create a folder on my Desktop named "Project Files"
Copy & paste β€” that's it
Open Safari and navigate to apple.com
Copy & paste β€” that's it
Tell me how much free space I have on my main drive
Copy & paste β€” that's it
List all my upcoming calendar events for this week

Development

Setup

Copy & paste β€” that's it
brew install uv
uv sync --dev

Run all checks (in parallel)

Copy & paste β€” that's it
uv run check

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

Individual commands

Copy & paste β€” that's it
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