AppleScript MCP server
Memungkinkan AI client menjalankan AppleScript di Mac untuk mengontrol aplikasi, file, reminders, calendar, messages, dan shell commands.
Juga dikenal sebagai peakmojo/applescript-mcp, @peakmojo/applescript-mcp
- Stars
- 468
- Tools
- —
- Unduhan, 30 hari
- —
- Versi terbaru
- —
- Commit terakhir
- 22 Feb 2026
- Lisensi
- MIT
Apa itu AppleScript MCP?
AppleScript adalah MCP server. Memungkinkan AI client menjalankan AppleScript di Mac untuk mengontrol aplikasi, file, reminders, calendar, messages, dan shell commands.
Ringkasan dibuat dari README proyek
Tentang AppleScript MCP server
Anda dapat mengontrol aplikasi macOS dan data sistem melalui AI client menggunakan MCP server ini. Tool ini memungkinkan pengguna mengeksekusi AppleScript untuk mengelola file, reminders, calendar, messages, dan notes secara langsung dari interface chat Anda. Dengan menjembatani celah antara language model dan sistem operasi Mac, Anda dapat melakukan interaksi otomatis dengan aplikasi native seperti Apple Music, Safari, dan Contacts.
Developer dapat melakukan setup secara lokal menggunakan Node.js via npx atau melalui Python menggunakan uvx. Bagi Anda yang bekerja di dalam Docker container, server ini mendukung remote execution melalui SSH dengan terhubung ke host machine. Setup ini memerlukan pengaktifan Remote Login di pengaturan sistem Mac Anda serta penyediaan kredensial user yang diperlukan. Server ini menyediakan cara untuk melakukan tugas sistem seperti mengecek persentase baterai, mencari file dengan Spotlight, atau menjalankan shell commands.
Apa yang bisa Anda lakukan dengannya
- 1Kelola jadwal dan tugas pribadiMinta AI untuk menambahkan meeting baru ke calendar Anda atau membuat reminders tertentu.
- 2Organisir dan cari file lokalMinta AI untuk menemukan file spesifik di folder Anda atau membuat direktori baru di desktop.
- 3Kontrol media dan pengaturan sistemInstruksikan AI untuk memutar playlist musik tertentu atau mengecek status hardware Anda.
- 4Otomatisasi komunikasi dan pengambilan kontakGunakan AI untuk mencari nomor telepon di kontak Anda atau mengecek pesan yang belum dibaca.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal AppleScript MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal AppleScript MCP di Claude Code
$ claude mcp add applescript-mcp -- npx -y @peakmojo/applescript-mcpInstal AppleScript MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"applescript-mcp": {
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}Instal AppleScript MCP di VS Code
.vscode/mcp.json
{
"servers": {
"applescript-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}Instal AppleScript MCP di VS Code CLI
$ code --add-mcp '{"name":"applescript-mcp","type":"stdio","command":"npx","args":["-y","@peakmojo/applescript-mcp"]}'Instal AppleScript MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"applescript-mcp": {
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}Instal AppleScript MCP di Codex
$ codex mcp add applescript-mcp -- npx -y @peakmojo/applescript-mcpInstal AppleScript MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.applescript-mcp] command = "npx" args = ["-y", "@peakmojo/applescript-mcp"]
Instal AppleScript MCP di Gemini CLI
$ gemini mcp add -s user applescript-mcp npx -- -y @peakmojo/applescript-mcpInstal AppleScript MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"applescript-mcp": {
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Belum diverifikasi. Sebuah server memerlukan skor 80, tidak ada temuan serius, dan data yang cukup untuk kami periksa. Cara kerja checks · Yang perlu diperbaiki untuk menambah poin
- Source repository terhubung dan dapat dijangkaupeakmojo/applescript-mcp is public and reachablegithub.com/peakmojo/applescript-mcp ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernya@peakmojo/applescript-mcp names peakmojo/applescript-mcp as sourcenpmjs.com/package/@peakmojo/applescript-mcp ↗Lolos
- Provenance build (atestasi Sigstore)No build attestation published for this releaseTidak diperiksa
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-02-22github.com/peakmojo/applescript-mcp ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerNo popular package one edit away from @peakmojo/applescript-mcpLolos
- Tidak ada advisory kritis pada paket atau dependensinyaTidak diperiksa
- Tidak ada instruksi tersembunyi untuk model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelTidak diperiksa
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di GitHubAppleScript 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
Pertanyaan tentang AppleScript MCP
Bagaimana cara menambahkan AppleScript MCP ke Claude Code?
Jalankan claude mcp add applescript-mcp -- npx -y @peakmojo/applescript-mcp di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan AppleScript MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Apa yang bisa dilakukan AppleScript MCP server di Mac saya?
Server ini menjalankan kode AppleScript untuk berinteraksi dengan aplikasi dan data Mac, termasuk Notes, Calendar, Contacts, Messages, file, dan shell commands.
Bagaimana cara menginstall AppleScript MCP server dengan Claude Desktop?
Tambahkan sebagai MCP server menggunakan npx dengan package @peakmojo/applescript-mcp, atau jalankan versi Python menggunakan uvx dari repo git.
Apakah bisa berjalan dari dalam Docker container?
Bisa, dengan menggunakan hostname host.docker.internal ditambah argumen remote host, user, dan password, serta mengaktifkan SSH di Mac Anda.
Apakah mendukung eksekusi jarak jauh (remote execution)?
Ya, remote execution didukung melalui SSH dengan menyertakan remote host, user, dan password.
Tool command-line apa yang dibutuhkan versi Python?
Versi Python berjalan melalui uv, yang dapat diinstall menggunakan Homebrew.