applescript-mcp

MCP.Pizza Chef: peakmojo

Underneath it runs AppleScript, the automation language built into macOS, which means most of what you would click, your assistant can do instead: set a reminder, add a calendar event, start a note, find files from last week, check the battery, play a playlist, take a screenshot, open a page in Safari. Setup is a short snippet pasted into Claude Desktop, with no key or account needed. Mac only. It can also run shell commands, so grant permissions thoughtfully.

Calendar
Files/PDF
Notes

Use This MCP server To

Create a reminder to call someone tomorrow morning Add a meeting to my calendar for Friday afternoon Start a new note with today's date Find every file I downloaded in the past week Play a particular playlist in Apple Music Take a screenshot and save it to my desktop Look up a phone number in my contacts

README

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.

AppleScript Server MCP server
applescript.mcp.demo.0422.mp4

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

applescript-mcp FAQ

Is this project still maintained?
Reasonably. The last change was in February 2026, and it is a deliberately small project, under a hundred lines at its core.
Does it work on Windows?
No. AppleScript exists only on macOS, so this is Mac-only.
Do I need a key or an account?
No. There is nothing to sign up for and nothing to pay.
How hard is setup?
You paste a few lines into Claude Desktop's settings file. macOS will then ask your permission the first time it touches Notes, Calendar, Contacts or Messages.
Can I use this to sort out my week?
Yes. Reminders, calendar events, notes and finding files are all standard requests, and you can chain several in one go.
Is it safe?
Treat it with care. It can run shell commands and reach your files, messages and mail, so only use it with an assistant you trust and watch what it proposes.