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

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

@peakmojo

リポジトリ

AppleScript MCP Server (Dual access: python and node.js) について

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

#macos #applescript #mcp #mcp-server

基本情報

カテゴリ

生産性

ライセンス

MIT

ランタイム

python

トランスポート

stdio

公開者

peakmojo

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "applescript-mcp": {
      "command": "uv",
      "args": [
        "sync",
        "--dev"
      ]
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

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

A Model Context Protocol (MCP) server that lets you run AppleScript code to interact with a Mac. It is designed to be simple, straightforward, and require minimal setup, providing dual access via either Python or Node.js.

How to use AppleScript MCP Server (Dual access: python and node.js)?

Install and run the server using npx for Node.js, or uvx (from the git repo) or uv (local development) for Python. Configure your MCP client (e.g., Claude Desktop) with the appropriate command and arguments as shown in the README.

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

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

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

Automate reminders, calendar events, and note creation on a Mac
Retrieve system information like battery level or free disk space
Control applications: play music, take screenshots, open Safari
Manage files: create folders, find recent downloads, read and write files
Access and search contacts, emails, and running applications

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

What runtime dependencies are required?

Node.js (for the npx command) or Python with uv installed (for the uvx or local setup). Optionally, SSH must be enabled on the Mac for remote execution.

How do I configure the server for Docker usage?

Use the npx command with --remoteHost, --remoteUser, and --remotePassword arguments. Ensure SSH is enabled on the Mac host and proper credentials are provided.

How do I run AppleScript remotely?

Use the remote execution feature via SSH by passing the SSH hostname, username, and password or key. The server can then execute AppleScript on a machine at the given address.

Can I use this server without cloning the repository?

Yes. For Python, you can run directly with uvx --from git+https://github.com/peakmojo/applescript-mcp mcp-server-applescript. For Node.js, use npx @peakmojo/applescript-mcp.

Are there any known limitations or security considerations?

The server executes arbitrary AppleScript and shell commands on the Mac. Use caution when granting it access, especially when using remote SSH execution.