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

applescript-mcp

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

설치

클라이언트 선택

사용 사례

실전 활용법: applescript-mcp

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

사전 조건

흐름

함정

Search and organize files on your Mac with applescript-mcp

사전 조건

흐름

함정

조합

다른 MCP와 조합해 10배 효율

도구

이 MCP가 노출하는 것

비용 및 제한

운영 비용

보안

권한, 시크릿, 파급범위

문제 해결

자주 발생하는 오류와 해결

대안

applescript-mcp 다른 것과 비교

더 보기

리소스