AppleScript MCP ServerServer

peakmojo
GitHub
Mac AutomationAppleScriptMCP

Loading subscription status...

๐Ÿ’ก Description

A Model Context Protocol (MCP) server that allows interaction with Mac applications and system functions through AppleScript. It is designed to be simple and intuitive, requiring minimal setup to run AppleScript codes to interact with applications like notes, calendars, contacts, messages, and file management.

๐Ÿ“ JSON Entries

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

โšก Features

  • Run AppleScript to access Mac applications and data
  • Interact with notes, calendar, contacts, messages
  • Search files using Spotlight or Finder
  • Read and write file contents, execute shell commands

๐Ÿ’ฌ Example Queries

  • 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