applescript-mcp

MCP.Pizza Chef: joshrutkowski

Ask for a calendar event and it appears in Calendar; ask what you have on today and it reads your schedule back. It also writes and searches Notes, drafts emails in Mail, sends and searches Messages, finds files in Finder, manages your clipboard, and flips dark mode or the volume. It runs on macOS only and needs no key. The warning is age: nothing has been committed since April 2025, and the Safari and Reminders features the author listed as planned never arrived.

Unmaintained ยท no commits since April 2025
Calendar
Email
Notes

Use This MCP server To

Add a meeting to my calendar without opening it Draft an email in Mail from a plain-language request Search my Messages for something someone sent me Create a note and find it again later Find every PDF in my Documents folder Copy text to my clipboard or read what is on it

README

applescript-mcp MCP Server

A Model Context Protocol server that enables LLM applications to interact with macOS through AppleScript. This server provides a standardized interface for AI applications to control system functions, manage files, handle notifications, and more.

Node.js CI

applescript-mcp MCP server

Features

  • ๐Ÿ—“๏ธ Calendar management (events, reminders)
  • ๐Ÿ“‹ Clipboard operations
  • ๐Ÿ” Finder integration
  • ๐Ÿ”” System notifications
  • โš™๏ธ System controls (volume, dark mode, apps)
  • ๐Ÿ“Ÿ iTerm terminal integration
  • ๐Ÿ“ฌ Mail (create new email, list emails, get email)
  • ๐Ÿ”„ Shortcuts automation
  • ๐Ÿ’ฌ Messages (list chats, get messages, search messages, send a message)
  • ๐Ÿ—’๏ธ Notes (create formatted notes, list notes, search notes)
  • ๐Ÿ“„ Pages (create documents)

Planned Features

  • ๐Ÿงญ Safari (open in Safari, save page content, get selected page/tab)
  • โœ… Reminders (create, get)

Prerequisites

  • macOS 10.15 or later
  • Node.js 18 or later

Available Categories

Calendar

Command Description Parameters
add Create calendar event title, startDate, endDate, calendar (optional)
list List today's events None

applescript-mcp FAQ

Is this project still maintained?
There is no sign of it. The last code change was April 2025, more than a year before this listing, and the planned Safari and Reminders features were never finished.
Does it work on Windows?
No. It drives macOS through AppleScript, so it needs a Mac running macOS 10.15 or later, plus Node.js 18 or later.
Do I need a key or an account?
No. Everything happens on your own machine, against apps you already have installed.
How hard is the setup?
Moderate. You paste a config snippet, then macOS prompts you to grant permission the first time it touches each app.
Can I use this to check today's calendar and message someone about it?
Yes. It can read today's events and send a Messages chat in the same request.
Is it safe to let an assistant loose on my Mac?
It can launch and quit apps and run terminal commands in iTerm, so only enable it if you are comfortable with that reach.
Which apps does it work in?
The project does not name specific assistants, but it runs anywhere you can add a locally installed server.