개요

Mac과 상호작용하기 위해 AppleScript 코드를 실행할 수 있게 해주는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 MCP는 의도적으로 간단하고 직관적이며 최소한의 설정으로 설계되었습니다.

이렇게 간단하고 강력할 줄은 믿기지 않아요. 핵심 코드는

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

특징

• Mac의 애플리케이션과 데이터에 접근하기 위해 AppleScript를 실행하세요
• 노트, 캘린더, 연락처, 메시지 등과 상호작용하기
• Spotlight 또는 Finder를 사용해 파일 검색
• 파일 내용을 읽기/쓰기 및 셸 명령 실행
• SSH를 통한 원격 실행 지원

예시 프롬프트

클로드 데스크톱에서의 사용

Node.js

파이썬 (UVX)

복제는 필요 없고 — git 저장소에서 직접 실행하세요:

파이썬 (로컬 개발)

로컬 개발을 위해 저장소를 복제하고 uv를 사용해 소스에서 실행하세요:

개발

설정

모든 검사를 (병렬로 실행하세요)

이 프로그램은 린팅, 포맷팅, 타입 검사, 테스트 등 100% 보장을 병행하여 실행합니다.

개별 명령

도커 사용

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