applescript-mcp MCP — Casos de uso, Instalar & Demo en vivo

Name: applescript-mcp MCP Server
Author: peakmojo

Por qué usarlo

Características clave

Execute any AppleScript command and return results to Claude
Control Notes, Calendar, Contacts, Messages, Finder, and other macOS apps
Spotlight file search and Finder operations
System info retrieval — battery, disk space, screenshots
Remote execution via SSH for Docker setups

Demo en vivo

Cómo se ve en la práctica

applescript-mcp.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "applescript-mcp": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/peakmojo/applescript-mcp"
      ]
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "applescript-mcp": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/peakmojo/applescript-mcp"
      ]
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "applescript-mcp": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/peakmojo/applescript-mcp"
      ]
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "applescript-mcp": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/peakmojo/applescript-mcp"
      ]
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "applescript-mcp",
      "command": "TODO",
      "args": [
        "See README: https://github.com/peakmojo/applescript-mcp"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "applescript-mcp": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/peakmojo/applescript-mcp"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add applescript-mcp -- TODO 'See README: https://github.com/peakmojo/applescript-mcp'

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: applescript-mcp

How to create calendar events with natural language using applescript-mcp

👤 Mac users who want to manage their calendar via Claude ⏱ ~5 min beginner

Cuándo usarlo: You want to quickly create, modify, or query calendar events without opening Calendar.app.

Requisitos previos

macOS with SSH enabled — System Settings → Sharing → Remote Login
applescript-mcp installed — npx -y @peakmojo/applescript-mcp or uvx applescript-mcp

Flujo

Create an event

Create a calendar event titled 'Team Standup' for tomorrow at 10am, 30 minutes long, in my Work calendar.✓ Copiado

→ Confirmation that the event was created with date and time
Query upcoming events

What events do I have this week?✓ Copiado

→ List of calendar events with times and titles

Resultado: Calendar events created and queried without leaving the chat.

Errores comunes

AppleScript uses calendar names that must match exactly — List available calendars first before creating events

Combinar con: filesystem

Search and organize files on your Mac with applescript-mcp

👤 Mac power users looking for file management automation ⏱ ~10 min intermediate

Cuándo usarlo: You need to find scattered files across your Mac and organize them.

Requisitos previos

applescript-mcp running — npx -y @peakmojo/applescript-mcp

Flujo

Search for files

Use Spotlight to find all PDF files on my Mac modified in the last week.✓ Copiado

→ List of file paths matching the criteria
Organize results

Move all those PDFs into ~/Documents/Recent-PDFs/, creating the folder if needed.✓ Copiado

→ Confirmation of files moved

Resultado: Files found via Spotlight and organized into a designated folder.

Errores comunes

Spotlight index may be incomplete — Ensure Spotlight indexing is enabled for the relevant drives in System Settings

Combinar con: filesystem

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

applescript-mcp + filesystem

Use AppleScript to find files via Spotlight, then filesystem MCP to read and process their contents

Find all .md files modified today using Spotlight, then read and summarize each one.✓ Copiado

applescript-mcp + github

Create calendar reminders for upcoming GitHub PR review deadlines

Check my open PR review requests on GitHub and create calendar reminders for any that are overdue.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
run_applescript	script: str	Execute any AppleScript command on the connected Mac	0

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: No external API — runs locally on macOS
Tokens por llamada: 200–1000 tokens per script execution
Monetario: Free
Consejo: Keep scripts focused on one task per call to minimize token usage from large outputs.

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: SSH credentials needed for remote execution — store in env vars, not in config files

Salida de datos: All execution is local to the Mac. No external network calls unless your script makes them.

WARNING: This MCP grants full system control via AppleScript. It can read/write files, send messages, execute shell commands, and control any application. Only use with trusted prompts and review scripts before execution.
Never run this on a production machine or with access to sensitive data you wouldn't want an AI to process.
SSH remote execution exposes the target Mac to any command the AI generates. Use strong credentials and restrict network access.

Resolución de problemas

Errores comunes y soluciones

AppleScript execution failed — not authorized

Grant Terminal (or your MCP host) access in System Settings → Privacy & Security → Automation and Accessibility.

Verificar: osascript -e 'tell application "Finder" to get name of every disk'

SSH connection refused

Enable Remote Login in System Settings → Sharing. Verify SSH credentials are correct.

Verificar: ssh your-user@localhost 'echo ok'

Application not responding to AppleScript

Some apps have limited or no AppleScript support. Check the app's AppleScript dictionary in Script Editor.

Verificar: Open Script Editor → File → Open Dictionary → select the app

Alternativas

applescript-mcp vs otros

Alternativa	Cuándo usarla	Contrapartida
filesystem MCP	You only need file read/write without controlling macOS apps	Much narrower scope but no system-level access risks

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills