Skip to content
Back to search

applescript-mcp

MCP server that execute applescript giving you full control of your Mac

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/peakmojo--applescript-mcp/badge.svg)](/listings/peakmojo--applescript-mcp)

HTML

<a href="/listings/peakmojo--applescript-mcp"><img src="/api/listings/peakmojo--applescript-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

brew install uv
uv sync --dev

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 194 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # AppleScript MCP Server (Dual access: python and node.js)
  2. [![npm version](https://img.shields.io/npm/v/@peakmojo/applescript-mcp.svg)](https://www.npmjs.com/package/@peakmojo/applescript-mcp) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
  3. ## Overview
  4. 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.
  5. I can't believe how simple and powerful it is. The core code is <100 line of code.
  6. <a href="https://glama.ai/mcp/servers/@peakmojo/applescript-mcp">
  7. <img width="380" height="200" src="https://glama.ai/mcp/servers/@peakmojo/applescript-mcp/badge" alt="AppleScript Server MCP server" />
  8. </a>
  9. https://github.com/user-attachments/assets/b85e63ba-fb26-4918-8e6d-2377254ee388
  10. ## Features
  11. * Run AppleScript to access Mac applications and data
  12. * Interact with Notes, Calendar, Contacts, Messages, and more
  13. * Search for files using Spotlight or Finder
  14. * Read/write file contents and execute shell commands
  15. * Remote execution support via SSH
  16. ## Example Prompts
  17. ```
  18. Create a reminder for me to call John tomorrow at 10am
  19. ```
  20. ```
  21. Add a new meeting to my calendar for Friday from 2-3pm titled "Team Review"
  22. ```
  23. ```
  24. Create a new note titled "Meeting Minutes" with today's date
  25. ```
  26. ```
  27. Show me all files in my Downloads folder from the past week
  28. ```
  29. ```
  30. What's my current battery percentage?
  31. ```
  32. ```
  33. Show me the most recent unread emails in my inbox
  34. ```
  35. ```
  36. List all the currently running applications on my Mac
  37. ```
  38. ```
  39. Play my "Focus" playlist in Apple Music
  40. ```
  41. ```
  42. Take a screenshot of my entire screen and save it to my Desktop
  43. ```
  44. ```
  45. Find John Smith in my contacts and show me his phone number
  46. ```
  47. ```
  48. Create a folder on my Desktop named "Project Files"
  49. ```
  50. ```
  51. Open Safari and navigate to apple.com
  52. ```
  53. ```
  54. Tell me how much free space I have on my main drive
  55. ```
  56. ```
  57. List all my upcoming calendar events for this week
  58. ```
  59. ## Usage with Claude Desktop
  60. ### Node.js
  61. ```json
  62. {
  63. "mcpServers": {
  64. "applescript_execute": {
  65. "command": "npx",
  66. "args": [
  67. "@peakmojo/applescript-mcp"
  68. ]
  69. }
  70. }
  71. }
  72. ```
  73. ### Python (uvx)
  74. No clone needed — run directly from the git repo:
  75. ```json
  76. {
  77. "mcpServers": {
  78. "applescript_execute": {
  79. "command": "uvx",
  80. "args": [
  81. "--from",
  82. "git+https://github.com/peakmojo/applescript-mcp",
  83. "mcp-server-applescript"
  84. ]
  85. }
  86. }
  87. }
  88. ```
  89. ### Python (local development)
  90. For local development, clone the repo and use `uv` to run from source:
  91. ```
  92. brew install uv
  93. git clone https://github.com/peakmojo/applescript-mcp.git
  94. ```
  95. ```json
  96. {
  97. "mcpServers": {
  98. "applescript_execute": {
  99. "command": "uv",
  100. "args": [
  101. "--directory",
  102. "/path/to/your/repo",
  103. "run",
  104. "mcp-server-applescript"
  105. ]
  106. }
  107. }
  108. }
  109. ```
  110. ## Development
  111. ### Setup
  112. ```bash
  113. brew install uv
  114. uv sync --dev
  115. ```
  116. ### Run all checks (in parallel)
  117. ```bash
  118. uv run check
  119. ```
  120. This runs linting, formatting, type checking, and tests with 100% coverage — all in parallel.
  121. ### Individual commands
  122. ```bash
  123. uv run lint # ruff linter
  124. uv run format # ruff auto-format
  125. uv run typecheck # pyrefly type checker
  126. uv run test # pytest with 100% coverage enforcement
  127. ```
  128. ## Docker Usage
  129. When running in a Docker container, you can use the special hostname `host.docker.internal` to connect to your Mac host:
  130. ### Configuration
  131. ```json
  132. {
  133. "mcpServers": {
  134. "applescript_execute": {
  135. "command": "npx",
  136. "args": [
  137. "@peakmojo/applescript-mcp",
  138. "--remoteHost", "host.docker.internal",
  139. "--remoteUser", "yourusername",
  140. "--remotePassword", "yourpassword"
  141. ]
  142. }
  143. }
  144. }
  145. ```
  146. This allows your Docker container to execute AppleScript on the Mac host system. Make sure:
  147. 1. SSH is enabled on your Mac (System Settings → Sharing → Remote Login)
  148. 2. Your user has proper permissions
  149. 3. The correct credentials are provided in the config

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.