applescript-mcp MCP — ユースケース, インストール & ライブデモ

Name: applescript-mcp MCP Server
Author: peakmojo

なぜ使うのか

主な機能

Execute any AppleScript command and return results to Claude
Control Notes, Calendar, Contacts, Messages, Finder, and other macOS apps
Spotlight file search and Finder operations
System info retrieval — battery, disk space, screenshots
Remote execution via SSH for Docker setups

ライブデモ

実際の動作

applescript-mcp.replay ▶ 準備完了

0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "applescript-mcp": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/peakmojo/applescript-mcp"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "applescript-mcp": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/peakmojo/applescript-mcp"
      ]
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "applescript-mcp": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/peakmojo/applescript-mcp"
      ]
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "applescript-mcp": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/peakmojo/applescript-mcp"
      ]
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "applescript-mcp",
      "command": "TODO",
      "args": [
        "See README: https://github.com/peakmojo/applescript-mcp"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json

{
  "context_servers": {
    "applescript-mcp": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/peakmojo/applescript-mcp"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add applescript-mcp -- TODO 'See README: https://github.com/peakmojo/applescript-mcp'

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方： applescript-mcp

How to create calendar events with natural language using applescript-mcp

👤 Mac users who want to manage their calendar via Claude ⏱ ~5 min beginner

使うタイミング： You want to quickly create, modify, or query calendar events without opening Calendar.app.

前提条件

macOS with SSH enabled — System Settings → Sharing → Remote Login
applescript-mcp installed — npx -y @peakmojo/applescript-mcp or uvx applescript-mcp

フロー

Create an event

Create a calendar event titled 'Team Standup' for tomorrow at 10am, 30 minutes long, in my Work calendar.✓ コピーしました

→ Confirmation that the event was created with date and time
Query upcoming events

What events do I have this week?✓ コピーしました

→ List of calendar events with times and titles

結果： Calendar events created and queried without leaving the chat.

注意点

AppleScript uses calendar names that must match exactly — List available calendars first before creating events

組み合わせ： filesystem

Search and organize files on your Mac with applescript-mcp

👤 Mac power users looking for file management automation ⏱ ~10 min intermediate

使うタイミング： You need to find scattered files across your Mac and organize them.

前提条件

applescript-mcp running — npx -y @peakmojo/applescript-mcp

フロー

Search for files

Use Spotlight to find all PDF files on my Mac modified in the last week.✓ コピーしました

→ List of file paths matching the criteria
Organize results

Move all those PDFs into ~/Documents/Recent-PDFs/, creating the folder if needed.✓ コピーしました

→ Confirmation of files moved

結果： Files found via Spotlight and organized into a designated folder.

注意点

Spotlight index may be incomplete — Ensure Spotlight indexing is enabled for the relevant drives in System Settings

組み合わせ： filesystem

組み合わせ

他のMCPと組み合わせて10倍の力を

applescript-mcp + filesystem

Use AppleScript to find files via Spotlight, then filesystem MCP to read and process their contents

Find all .md files modified today using Spotlight, then read and summarize each one.✓ コピーしました

applescript-mcp + github

Create calendar reminders for upcoming GitHub PR review deadlines

Check my open PR review requests on GitHub and create calendar reminders for any that are overdue.✓ コピーしました

ツール

このMCPが提供する機能

ツール	入力	呼び出すタイミング	コスト
run_applescript	script: str	Execute any AppleScript command on the connected Mac	0

コストと制限

運用コスト

APIクォータ: No external API — runs locally on macOS
呼び出しあたりのトークン: 200–1000 tokens per script execution
金額: Free
ヒント: Keep scripts focused on one task per call to minimize token usage from large outputs.

セキュリティ

権限、シークレット、影響範囲

認証情報の保管： SSH credentials needed for remote execution — store in env vars, not in config files

データ送信先： All execution is local to the Mac. No external network calls unless your script makes them.

WARNING: This MCP grants full system control via AppleScript. It can read/write files, send messages, execute shell commands, and control any application. Only use with trusted prompts and review scripts before execution.
Never run this on a production machine or with access to sensitive data you wouldn't want an AI to process.
SSH remote execution exposes the target Mac to any command the AI generates. Use strong credentials and restrict network access.

トラブルシューティング

よくあるエラーと対処法

AppleScript execution failed — not authorized

Grant Terminal (or your MCP host) access in System Settings → Privacy & Security → Automation and Accessibility.

確認： osascript -e 'tell application "Finder" to get name of every disk'

SSH connection refused

Enable Remote Login in System Settings → Sharing. Verify SSH credentials are correct.

確認： ssh your-user@localhost 'echo ok'

Application not responding to AppleScript

Some apps have limited or no AppleScript support. Check the app's AppleScript dictionary in Script Editor.

確認： Open Script Editor → File → Open Dictionary → select the app

代替案

applescript-mcp 他との比較

代替案	代わりに使う場面	トレードオフ
filesystem MCP	You only need file read/write without controlling macOS apps	Much narrower scope but no system-level access risks

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る