概要

Macとやり取りするためにAppleScriptコードを実行できるModel Context Protocol(MCP)サーバーです。このMCPは意図的にシンプルでわかりやすく直感的で、最小限のセットアップで済むように設計されています。

こんなにシンプルで強力なものだとは信じられません。コアコードは

https://github.com/user-attachments/assets/b85e63ba-fb26-4918-8e6d-2377254ee388

特徴

• MacのアプリケーションやデータにアクセスするためにAppleScriptを実行する
• メモ、カレンダー、連絡先、メッセージなどとやり取り
• SpotlightまたはFinderでファイルを検索
• ファイルの内容の読み書きおよびシェルコマンドの実行
• SSHによるリモート実行サポート

例示プロンプト

Claude Desktopでの使用

Node.js

Python (uvx)

クローンは不要です — gitリポジトリから直接実行してください:

Python(ローカル開発)

ローカル開発の場合は、リポジトリをクローンし、uvを使ってソースから実行します:

開発

セットアップ

すべてのチェックを(並行して)

このシステムはリンティング、フォーマット、タイプチェック、テストを100%のカバレッジで並行して実行します。

個別のコマンド

Docker の使用

Dockerコンテナ上で動作する場合、特別なホスト名host.docker.internalを使ってMacホストに接続できます:

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
• Remote execution support via SSH

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 (uvx)

No clone needed — run directly from the git repo:

{
  "mcpServers": {
    "applescript_execute": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/peakmojo/applescript-mcp",
        "mcp-server-applescript"
      ]
    }
  }
}

Python (local development)

For local development, clone the repo and use uv to run from source:

brew install uv
git clone https://github.com/peakmojo/applescript-mcp.git

{
  "mcpServers": {
    "applescript_execute": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/repo",
        "run",
        "mcp-server-applescript"
      ]
    }
  }
}

Development

Setup