Skip to main content
Glama
Sign In
enesjakozh

AppleScript MCP Server

by peakmojo
GitHub
Python
MIT License
2
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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

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.

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

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

{ "mcpServers": { "applescript_execute": { "command": "npx", "args": [ "@peakmojo/applescript-mcp" ] } } }

Python

Install uv

brew install uv git clone ...

Run the server

{ "mcpServers": { "applescript_execute": { "command": "uv", "args": [ "--directory", "/path/to/your/repo", "run", "src/applescript_mcp/server.py" ] } } }

This server cannot be installed

-
security - not tested
-
license - not tested
-
quality - not tested

A Model Context Protocol server that enables running AppleScript code to interact with Mac applications and system features including Notes, Calendar, Contacts, Messages, file management, and more.

  1. Overview
    1. Features
      1. Example Prompts
        1. Usage with Claude Desktop
          1. Node.js
          2. Python

        Related MCP Servers

        • Calculator MCP Server

          QuantGeekDev
          -
          security
          F
          license
          -
          quality
          A Model Context Protocol server built with mcp-framework that allows users to create and manage custom tools for processing data, integrating with the Claude Desktop via CLI.
          Last updated -
          48
          4
          TypeScript
          • Apple

        • Blender MCP Server

          cwahlfeldt
          -
          security
          F
          license
          -
          quality
          A Model Context Protocol server that allows management and execution of Blender Python scripts, enabling users to create, edit and run scripts in a headless Blender environment through natural language interfaces.
          Last updated -
          4
          Python

        • Filesystem MCP Server

          bsmi021
          -
          security
          A
          license
          -
          quality
          A Model Context Protocol server that provides file system operations, analysis, and manipulation capabilities through a standardized tool interface.
          Last updated -
          1
          TypeScript
          MIT License

        • Python Apple MCP

          jxnl
          -
          security
          F
          license
          -
          quality
          A Python server that enables interaction with macOS native applications (Contacts, Notes, Mail, Messages, Reminders, Calendar, and Maps) through AppleScript, featuring asynchronous operations and type-safe interfaces.
          Last updated -
          1
          Python
          • Apple

        View all related MCP servers

        ID: 1yvyjay7l2