Serveur MCP AppleScript
Permet à un client IA d'exécuter AppleScript sur un Mac pour contrôler les applications, les fichiers, les rappels, les calendriers, les messages et les commandes shell.
Aussi connu sous peakmojo/applescript-mcp, @peakmojo/applescript-mcp
- Étoiles
- 468
- Outils
- —
- Téléchargements, 30 jours
- —
- Dernière version
- —
- Dernier commit
- 22 févr. 2026
- Licence
- MIT
Qu'est-ce que AppleScript MCP ?
Permet à un client IA d'exécuter AppleScript sur un Mac pour contrôler les applications, les fichiers, les rappels, les calendriers, les messages et les commandes shell.
Résumé généré à partir du README du projet
À propos du MCP server AppleScript
Le contrôle des applications macOS et des données système via un client IA est possible grâce à ce MCP server. Il permet aux utilisateurs d'exécuter AppleScript pour gérer les fichiers, les rappels, les calendriers, les messages et les notes directement depuis leur interface de chat. En comblant le fossé entre les modèles de langage et le système d'exploitation Mac, il permet des interactions automatisées avec des applications natives comme Apple Music, Safari et Contacts.
Les développeurs peuvent configurer cela localement en utilisant Node.js via npx ou via Python en utilisant uvx. Pour ceux qui travaillent dans des conteneurs Docker, le serveur prend en charge l'exécution à distance via SSH en se connectant à la machine hôte. Cette configuration nécessite l'activation de l'accès distant (Remote Login) dans les réglages système de votre Mac et la fourniture des identifiants utilisateur nécessaires. Le serveur offre un moyen d'effectuer des tâches système telles que vérifier le pourcentage de batterie, rechercher des fichiers avec Spotlight ou exécuter des commandes shell.
Ce que vous pouvez faire avec
- 1Gérer les agendas et les tâches personnellesDemandez à l'IA d'ajouter de nouvelles réunions à votre calendrier ou de créer des rappels spécifiques.
- 2Organiser et rechercher des fichiers locauxDemandez à l'IA de trouver des fichiers spécifiques dans vos dossiers ou de créer de nouveaux répertoires sur votre bureau.
- 3Contrôler les médias et les paramètres systèmeDonnez instruction à l'IA pour lire des playlists musicales spécifiques ou vérifier l'état de votre matériel.
- 4Automatiser la communication et la récupération de contactsUtilisez l'IA pour trouver des numéros de téléphone dans vos contacts ou consulter vos messages non lus.
Extrait du README du projet. Chaque cas d'utilisation est vérifié par rapport à une citation du document.
Comment installer AppleScript MCP
Formats vérifiés le 10 nov. 2026Ajouter à CursorAjouter à GooseInstaller AppleScript MCP dans Claude Code
$ claude mcp add applescript-mcp -- npx -y @peakmojo/applescript-mcpInstaller AppleScript MCP dans Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"applescript-mcp": {
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}Installer AppleScript MCP dans VS Code
.vscode/mcp.json
{
"servers": {
"applescript-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}Installer AppleScript MCP dans VS Code CLI
$ code --add-mcp '{"name":"applescript-mcp","type":"stdio","command":"npx","args":["-y","@peakmojo/applescript-mcp"]}'Installer AppleScript MCP dans Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"applescript-mcp": {
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}Installer AppleScript MCP dans Codex
$ codex mcp add applescript-mcp -- npx -y @peakmojo/applescript-mcpInstaller AppleScript MCP dans Codex config.toml
~/.codex/config.toml
[mcp_servers.applescript-mcp] command = "npx" args = ["-y", "@peakmojo/applescript-mcp"]
Installer AppleScript MCP dans Gemini CLI
$ gemini mcp add -s user applescript-mcp npx -- -y @peakmojo/applescript-mcpInstaller AppleScript MCP dans Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"applescript-mcp": {
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}Vérifications automatisées
Exécuté le 14 nov. 2026Rapport complet →Pas encore vérifié. Un serveur nécessite un score de 80, aucune faille sérieuse et suffisamment de données pour que nous puissions effectuer les vérifications. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessiblepeakmojo/applescript-mcp is public and reachablegithub.com/peakmojo/applescript-mcp ↗Réussi
- Le nom du package correspond au dépôt source@peakmojo/applescript-mcp names peakmojo/applescript-mcp as sourcenpmjs.com/package/@peakmojo/applescript-mcp ↗Réussi
- Provenance du build (attestation Sigstore)No build attestation published for this releaseNon vérifié
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit or release 2026-02-22github.com/peakmojo/applescript-mcp ↗Réussi
- OpenSSF ScorecardNon vérifié
- Nom du package non proche d'un package populaireNo popular package one edit away from @peakmojo/applescript-mcpRéussi
- Aucun avis critique dans le package ou ses dépendancesNon vérifié
- Aucune instruction cachée destinée au modèle0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersRéussi
- Les outils destructifs sont étiquetésNon vérifié
- Le point de terminaison distant répond à la poignée de main MCPNon vérifié
README
Voir sur 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
Questions sur AppleScript MCP
Comment ajouter AppleScript MCP à Claude Code ?
Exécutez claude mcp add applescript-mcp -- npx -y @peakmojo/applescript-mcp dans votre terminal. Ajoutez --scope user pour le rendre disponible dans tous les projets.
Comment ajouter AppleScript MCP à Cursor ?
Ouvrez ~/.cursor/mcp.json et ajoutez le serveur sous mcpServers, avec la configuration Cursor indiquée dans la section d'installation ci-dessus.
Que peut faire le MCP server AppleScript sur mon Mac ?
Il exécute du code AppleScript pour interagir avec les applications et les données du Mac, notamment Notes, Calendrier, Contacts, Messages, les fichiers et les commandes shell.
Comment installer le MCP server AppleScript avec Claude Desktop ?
Ajoutez-le en tant que MCP server via npx avec le package @peakmojo/applescript-mcp, ou lancez la version Python avec uvx depuis le dépôt git.
Peut-il fonctionner depuis un conteneur Docker ?
Oui, en utilisant l'hôte host.docker.internal ainsi que les arguments de l'hôte distant, de l'utilisateur et du mot de passe, avec SSH activé sur le Mac.
Prend-il en charge l'exécution à distance ?
Oui, l'exécution à distance est prise en charge via SSH avec un hôte, un utilisateur et un mot de passe distants.
De quel outil en ligne de commande la version Python a-t-elle besoin ?
La version Python s'exécute via uv, qui peut être installé avec Homebrew.