AppleScript MCP server
AI 클라이언트가 Mac에서 AppleScript를 실행하여 앱, 파일, 미리 알림, 캘린더, 메시지 및 셸 명령어를 제어할 수 있게 합니다.
다른 이름 peakmojo/applescript-mcp, @peakmojo/applescript-mcp
- 스타
- 468
- Tools
- —
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 2월 22일
- 라이선스
- MIT
AppleScript MCP란?
AppleScript은(는) MCP server입니다. AI 클라이언트가 Mac에서 AppleScript를 실행하여 앱, 파일, 미리 알림, 캘린더, 메시지 및 셸 명령어를 제어할 수 있게 합니다.
프로젝트 README에서 생성된 요약
AppleScript MCP server 정보
이 MCP server를 사용하면 AI 클라이언트를 통해 macOS 애플리케이션과 시스템 데이터를 제어할 수 있습니다. 사용자는 채팅 인터페이스에서 직접 AppleScript를 실행하여 파일, 미리 알림, 캘린더, 메시지 및 메모를 관리할 수 있습니다. 언어 모델과 Mac 운영체제 사이의 간극을 메워줌으로써 Apple Music, Safari, Contacts와 같은 네이티브 앱과의 자동화된 상호작용을 가능하게 합니다.
개발자는 Node.js의 npx를 사용하거나 Python의 uvx를 사용하여 로컬에 설정할 수 있습니다. Docker 컨테이너 환경에서 작업하는 경우, 이 서버는 호스트 머신에 연결하는 SSH 기반 원격 실행을 지원합니다. 이 설정을 위해서는 Mac 시스템 설정에서 원격 로그인(Remote Login)을 활성화하고 필요한 사용자 자격 증명을 제공해야 합니다. 이 서버를 통해 배터리 잔량 확인, Spotlight를 이용한 파일 검색, 셸 명령어 실행과 같은 시스템 작업을 수행할 수 있습니다.
활용 사례
- 1개인 일정 및 작업 관리AI에게 캘린더에 새로운 회의를 추가하거나 특정 미리 알림을 생성하도록 요청합니다.
- 2로컬 파일 정리 및 검색AI에게 폴더 내 특정 파일을 찾거나 데스크탑에 새 디렉토리를 생성하도록 요청합니다.
- 3미디어 및 시스템 설정 제어AI에게 특정 음악 플레이리스트를 재생하거나 하드웨어 상태를 확인하도록 지시합니다.
- 4커뮤니케이션 및 연락처 조회 자동화AI를 사용하여 연락처에서 전화번호를 찾거나 읽지 않은 메시지를 확인합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
AppleScript MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 AppleScript MCP 설치
$ claude mcp add applescript-mcp -- npx -y @peakmojo/applescript-mcpCursor에 AppleScript MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"applescript-mcp": {
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}VS Code에 AppleScript MCP 설치
.vscode/mcp.json
{
"servers": {
"applescript-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}VS Code CLI에 AppleScript MCP 설치
$ code --add-mcp '{"name":"applescript-mcp","type":"stdio","command":"npx","args":["-y","@peakmojo/applescript-mcp"]}'Claude Desktop에 AppleScript MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"applescript-mcp": {
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}Codex에 AppleScript MCP 설치
$ codex mcp add applescript-mcp -- npx -y @peakmojo/applescript-mcpCodex config.toml에 AppleScript MCP 설치
~/.codex/config.toml
[mcp_servers.applescript-mcp] command = "npx" args = ["-y", "@peakmojo/applescript-mcp"]
Gemini CLI에 AppleScript MCP 설치
$ gemini mcp add -s user applescript-mcp npx -- -y @peakmojo/applescript-mcpGemini settings.json에 AppleScript MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"applescript-mcp": {
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}자동 검사
2026년 11월 14일에 실행됨전체 보고서 →아직 인증되지 않았습니다. 서버는 80점 이상의 점수, 심각한 결함 없음, 그리고 검사에 충분한 데이터를 갖추어야 합니다. 검사 방식 · 점수를 높이기 위해 수정할 항목
- 소스 저장소 연결 및 접근 가능peakmojo/applescript-mcp is public and reachablegithub.com/peakmojo/applescript-mcp ↗통과
- 패키지가 이 저장소를 소스로 명시@peakmojo/applescript-mcp names peakmojo/applescript-mcp as sourcenpmjs.com/package/@peakmojo/applescript-mcp ↗통과
- 빌드 출처(Sigstore 증명)No build attestation published for this release검사되지 않음
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-02-22github.com/peakmojo/applescript-mcp ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from @peakmojo/applescript-mcp통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음0 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기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
brew install uv
uv sync --dev
Run all checks (in parallel)
uv run check
This runs linting, formatting, type checking, and tests with 100% coverage — all in parallel.
Individual commands
uv run lint # ruff linter
uv run format # ruff auto-format
uv run typecheck # pyrefly type checker
uv run test # pytest with 100% coverage enforcement
Docker Usage
When running in a Docker container, you can use the special hostname host.docker.internal to connect to your Mac host:
Configuration
{
"mcpServers": {
"applescript_execute": {
"command": "npx",
"args": [
"@peakmojo/applescript-mcp",
"--remoteHost", "host.docker.internal",
"--remoteUser", "yourusername",
"--remotePassword", "yourpassword"
]
}
}
}
This allows your Docker container to execute AppleScript on the Mac host system. Make sure:
- SSH is enabled on your Mac (System Settings → Sharing → Remote Login)
- Your user has proper permissions
- The correct credentials are provided in the config
AppleScript MCP 질문
AppleScript MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add applescript-mcp -- npx -y @peakmojo/applescript-mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
AppleScript MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
Mac에서 AppleScript MCP server로 무엇을 할 수 있나요?
AppleScript 코드를 실행하여 Notes, Calendar, Contacts, Messages, 파일 및 셸 명령어를 포함한 Mac 애플리케이션 및 데이터와 상호작용합니다.
Claude Desktop에 AppleScript MCP server를 어떻게 설치하나요?
@peakmojo/applescript-mcp 패키지를 npx로 사용하여 MCP server로 추가하거나, git repo에서 uvx를 통해 Python 버전을 실행합니다.
Docker 컨테이너 내부에서도 작동하나요?
네, Mac에서 SSH를 활성화한 후 host.docker.internal 호스트 이름과 원격 호스트, 사용자, 비밀번호 인수를 사용하면 됩니다.
원격 실행을 지원하나요?
네, 원격 호스트, 사용자, 비밀번호를 포함한 SSH를 통해 원격 실행을 지원합니다.
Python 버전은 어떤 커맨드라인 도구가 필요한가요?
Python 버전은 uv를 통해 실행되며, uv는 Homebrew로 설치할 수 있습니다.