MCP server de AppleScript
Permite que un cliente de IA ejecute AppleScript en un Mac para controlar aplicaciones, archivos, recordatorios, calendarios, mensajes y comandos de shell.
También conocido como peakmojo/applescript-mcp, @peakmojo/applescript-mcp
- Stars
- 468
- Herramientas
- —
- Descargas, 30 días
- —
- Última versión
- —
- Último commit
- 22 feb 2026
- Licencia
- MIT
¿Qué es AppleScript MCP?
AppleScript es un MCP server. Permite que un cliente de IA ejecute AppleScript en un Mac para controlar aplicaciones, archivos, recordatorios, calendarios, mensajes y comandos de shell.
Resumen generado a partir del README del proyecto
Acerca del MCP server de AppleScript
Controlar las aplicaciones de macOS y los datos del sistema a través de un cliente de IA es posible con este MCP server. Permite a los usuarios ejecutar AppleScript para gestionar archivos, recordatorios, calendarios, mensajes y notas directamente desde su interfaz de chat. Al cerrar la brecha entre los modelos de lenguaje y el sistema operativo Mac, permite interacciones automatizadas con aplicaciones nativas como Apple Music, Safari y Contactos.
Los desarrolladores pueden configurar esto localmente usando Node.js a través de npx o mediante Python usando uvx. Para quienes trabajan dentro de contenedores Docker, el servidor admite la ejecución remota por SSH conectándose a la máquina host. Esta configuración requiere habilitar el Acceso remoto en los ajustes del sistema de tu Mac y proporcionar las credenciales de usuario necesarias. El servidor ofrece una forma de realizar tareas del sistema como consultar el porcentaje de batería, buscar archivos con Spotlight o ejecutar comandos de shell.
Qué puedes hacer con él
- 1Gestionar agendas y tareas personalesPide a la IA que añada nuevas reuniones a tu calendario o que cree recordatorios específicos.
- 2Organizar y buscar archivos localesSolicita a la IA que encuentre archivos específicos en tus carpetas o que cree nuevos directorios en tu escritorio.
- 3Controlar medios y ajustes del sistemaIndica a la IA que reproduzca listas de reproducción de música específicas o que compruebe el estado de tu hardware.
- 4Automatizar la comunicación y la recuperación de contactosUsa la IA para buscar números de teléfono en tus contactos o revisar mensajes no leídos.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar AppleScript MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar AppleScript MCP en Claude Code
$ claude mcp add applescript-mcp -- npx -y @peakmojo/applescript-mcpInstalar AppleScript MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"applescript-mcp": {
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}Instalar AppleScript MCP en VS Code
.vscode/mcp.json
{
"servers": {
"applescript-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}Instalar AppleScript MCP en VS Code CLI
$ code --add-mcp '{"name":"applescript-mcp","type":"stdio","command":"npx","args":["-y","@peakmojo/applescript-mcp"]}'Instalar AppleScript MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"applescript-mcp": {
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}Instalar AppleScript MCP en Codex
$ codex mcp add applescript-mcp -- npx -y @peakmojo/applescript-mcpInstalar AppleScript MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.applescript-mcp] command = "npx" args = ["-y", "@peakmojo/applescript-mcp"]
Instalar AppleScript MCP en Gemini CLI
$ gemini mcp add -s user applescript-mcp npx -- -y @peakmojo/applescript-mcpInstalar AppleScript MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"applescript-mcp": {
"command": "npx",
"args": [
"-y",
"@peakmojo/applescript-mcp"
]
}
}
}Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Aún no verificado. Un servidor necesita una puntuación de 80, ningún hallazgo grave y suficientes datos para que podamos revisarlo. Cómo funcionan las verificaciones · Qué corregir para obtener más puntos
- Repositorio de origen vinculado y accesiblepeakmojo/applescript-mcp is public and reachablegithub.com/peakmojo/applescript-mcp ↗Aprobado
- El paquete indica este repositorio como su origen@peakmojo/applescript-mcp names peakmojo/applescript-mcp as sourcenpmjs.com/package/@peakmojo/applescript-mcp ↗Aprobado
- Procedencia de la compilación (atestación de Sigstore)No build attestation published for this releaseNo verificado
- Licencia de código abierto (OSI)MITspdx.org/licenses/MIT.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-02-22github.com/peakmojo/applescript-mcp ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from @peakmojo/applescript-mcpAprobado
- No hay avisos críticos en el paquete ni en sus dependenciasNo verificado
- Sin instrucciones ocultas para el modelo0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo verificado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en 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
Preguntas sobre AppleScript MCP
¿Cómo agrego AppleScript MCP a Claude Code?
Ejecuta claude mcp add applescript-mcp -- npx -y @peakmojo/applescript-mcp en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego AppleScript MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué puede hacer el MCP server de AppleScript en mi Mac?
Ejecuta código AppleScript para interactuar con aplicaciones y datos de Mac, incluyendo Notas, Calendario, Contactos, Mensajes, archivos y comandos de shell.
¿Cómo instalo el MCP server de AppleScript con Claude Desktop?
Añádelo como un MCP server usando npx con el paquete @peakmojo/applescript-mcp, o ejecuta la versión de Python con uvx desde el repositorio de git.
¿Puede funcionar desde dentro de un contenedor Docker?
Sí, usando el hostname host.docker.internal junto con los argumentos de host remoto, usuario y contraseña, con SSH habilitado en el Mac.
¿Soporta la ejecución remota?
Sí, la ejecución remota es compatible a través de SSH con un host remoto, usuario y contraseña.
¿Qué herramienta de línea de comandos necesita la versión de Python?
La versión de Python se ejecuta mediante uv, que se puede instalar con Homebrew.