AppleScript MCP server
Ermöglicht es einem AI-Client, AppleScript auf einem Mac auszuführen, um Apps, Dateien, Erinnerungen, Kalender, Nachrichten und Shell-Commands zu steuern.
Auch bekannt als peakmojo/applescript-mcp, @peakmojo/applescript-mcp
- Stars
- 468
- Tools
- —
- Downloads, 30 Tage
- —
- Neueste Version
- —
- Letzter Commit
- 22. Feb. 2026
- Lizenz
- MIT
Was ist AppleScript MCP?
AppleScript ist ein MCP server. Ermöglicht es einem AI-Client, AppleScript auf einem Mac auszuführen, um Apps, Dateien, Erinnerungen, Kalender, Nachrichten und Shell-Commands zu steuern.
Zusammenfassung generiert aus dem README des Projekts
Über AppleScript MCP server
Mit diesem MCP server kannst du macOS-Anwendungen und Systemdaten direkt über einen AI-Client steuern. Er ermöglicht es dir, AppleScript auszuführen, um Dateien, Erinnerungen, Kalender, Nachrichten und Notizen direkt aus deinem Chat-Interface zu verwalten. Durch die Verbindung zwischen Sprachmodellen und dem Mac-Betriebssystem werden automatisierte Interaktionen mit nativen Apps wie Apple Music, Safari und Contacts möglich.
Entwickler können dies lokal mit Node.js via npx oder mit Python via uvx einrichten. Wer in Docker-Containern arbeitet, kann den Server über SSH nutzen, um eine Verbindung zum Host-Rechner herzustellen. Diese Konfiguration erfordert, dass du den Remote Login in deinen Mac-Systemeinstellungen aktivierst und die entsprechenden Benutzerdaten bereitstellst. Der Server bietet zudem die Möglichkeit, Systemaufgaben wie das Prüfen des Batteriestands, die Dateisuche via Spotlight oder das Ausführen von Shell-Commands zu erledigen.
Was du damit machen kannst
- 1Persönliche Zeitpläne und Aufgaben verwaltenBitte die AI, neue Termine in deinen Kalender einzutragen oder spezifische Erinnerungen zu erstellen.
- 2Lokale Dateien organisieren und durchsuchenFordere die AI auf, bestimmte Dateien in deinen Ordnern zu finden oder neue Verzeichnisse auf deinem Desktop zu erstellen.
- 3Medien und Systemeinstellungen steuernGib der AI den Befehl, bestimmte Musik-Playlists abzuspielen oder deinen Hardware-Status zu prüfen.
- 4Kommunikation und Kontaktsuche automatisierenNutze die AI, um Telefonnummern in deinen Kontakten zu finden oder ungelesene Nachrichten zu prüfen.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du AppleScript MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenAppleScript MCP in Claude Code installieren
$ claude mcp add applescript-mcp -- npx -y @peakmojo/applescript-mcpAppleScript MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"applescript-mcp": {
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}AppleScript MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"applescript-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}AppleScript MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"applescript-mcp","type":"stdio","command":"npx","args":["-y","@peakmojo/applescript-mcp"]}'AppleScript MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"applescript-mcp": {
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}AppleScript MCP in Codex installieren
$ codex mcp add applescript-mcp -- npx -y @peakmojo/applescript-mcpAppleScript MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.applescript-mcp] command = "npx" args = ["-y", "@peakmojo/applescript-mcp"]
AppleScript MCP in Gemini CLI installieren
$ gemini mcp add -s user applescript-mcp npx -- -y @peakmojo/applescript-mcpAppleScript MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"applescript-mcp": {
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Noch nicht verifiziert. Ein Server benötigt einen Score von 80, keine kritischen Befunde und genug Daten für unsere Prüfung. Wie die Checks funktionieren · Was du für mehr Punkte verbessern kannst
- Source Repository verknüpft und erreichbarpeakmojo/applescript-mcp is public and reachablegithub.com/peakmojo/applescript-mcp ↗Bestanden
- Paket nennt dieses Repository als Quelle@peakmojo/applescript-mcp names peakmojo/applescript-mcp as sourcenpmjs.com/package/@peakmojo/applescript-mcp ↗Bestanden
- Build-Provenienz (Sigstore-Attestierung)No build attestation published for this releaseNicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-02-22github.com/peakmojo/applescript-mcp ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from @peakmojo/applescript-mcpBestanden
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenNicht geprüft
- Keine versteckten Anweisungen an das Modell0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNicht geprüft
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenAppleScript 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 Fragen
Wie füge ich AppleScript MCP zu Claude Code hinzu?
Führe claude mcp add applescript-mcp -- npx -y @peakmojo/applescript-mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich AppleScript MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Was kann der AppleScript MCP server auf meinem Mac tun?
Er führt AppleScript-Code aus, um mit Mac-Anwendungen und Daten zu interagieren, einschließlich Notes, Calendar, Contacts, Messages, Dateien und Shell-Commands.
Wie installiere ich den AppleScript MCP server mit Claude Desktop?
Füge ihn als MCP server über npx mit dem Package @peakmojo/applescript-mcp hinzu oder starte die Python-Version mit uvx aus dem Git-Repo.
Funktioniert es auch aus einem Docker-Container heraus?
Ja, indem du den Hostnamen host.docker.internal zusammen mit den Argumenten für Remote Host, User und Password nutzt, sofern SSH auf dem Mac aktiviert ist.
Wird Remote Execution unterstützt?
Ja, Remote Execution wird via SSH mit einem Remote Host, User und Password unterstützt.
Welches CLI-Tool benötigt die Python-Version?
Die Python-Version läuft über uv, das du mit Homebrew installieren kannst.