/ الدليل / الملعب / applescript-mcp
← كل الخوادم ↗ GitHub
● مجتمع peakmojo ⚡ فوري

applescript-mcp

بواسطة peakmojo · peakmojo/applescript-mcp

Execute AppleScript from Claude to control any macOS app — Notes, Calendar, Finder, Messages, and more.

applescript-mcp gives Claude the ability to run arbitrary AppleScript on macOS, providing programmatic control over system apps and services. It can create calendar events, manage notes, search files via Spotlight, take screenshots, control media playback, and run shell commands. Available in Python and Node.js, with Docker support for remote execution via SSH.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

applescript-mcp.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/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"
      ]
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

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

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "applescript-mcp": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/peakmojo/applescript-mcp"
      ]
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

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

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

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

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

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

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

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

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: 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

متى تستخدمه: You want to quickly create, modify, or query calendar events without opening Calendar.app.

المتطلبات الأساسية
  • macOS with SSH enabled — System Settings → Sharing → Remote Login
  • applescript-mcp installed — npx -y @peakmojo/applescript-mcp or uvx applescript-mcp
الخطوات
  1. Create an event
    Create a calendar event titled 'Team Standup' for tomorrow at 10am, 30 minutes long, in my Work calendar.✓ تم النسخ
    → Confirmation that the event was created with date and time
  2. Query upcoming events
    What events do I have this week?✓ تم النسخ
    → List of calendar events with times and titles

النتيجة: Calendar events created and queried without leaving the chat.

المزالق
  • AppleScript uses calendar names that must match exactly — List available calendars first before creating events
اجمعها مع: filesystem

Search and organize files on your Mac with applescript-mcp

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

متى تستخدمه: You need to find scattered files across your Mac and organize them.

المتطلبات الأساسية
  • applescript-mcp running — npx -y @peakmojo/applescript-mcp
الخطوات
  1. Search for files
    Use Spotlight to find all PDF files on my Mac modified in the last week.✓ تم النسخ
    → List of file paths matching the criteria
  2. Organize results
    Move all those PDFs into ~/Documents/Recent-PDFs/, creating the folder if needed.✓ تم النسخ
    → Confirmation of files moved

النتيجة: Files found via Spotlight and organized into a designated folder.

المزالق
  • Spotlight index may be incomplete — Ensure Spotlight indexing is enabled for the relevant drives in System Settings
اجمعها مع: filesystem

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

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.✓ تم النسخ
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.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
run_applescript script: str Execute any AppleScript command on the connected Mac 0

التكلفة والحدود

تكلفة التشغيل

حصة API
No external API — runs locally on macOS
الرموز لكل استدعاء
200–1000 tokens per script execution
التكلفة المالية
Free
نصيحة
Keep scripts focused on one task per call to minimize token usage from large outputs.

الأمان

الصلاحيات والأسرار ونطاق الأثر

تخزين بيانات الاعتماد: SSH credentials needed for remote execution — store in env vars, not in config files
نقل البيانات الخارجي: All execution is local to the Mac. No external network calls unless your script makes them.

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

AppleScript execution failed — not authorized

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

تحقق: 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.

تحقق: 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.

تحقق: Open Script Editor → File → Open Dictionary → select the app

البدائل

applescript-mcp مقابل البدائل

البديلمتى تستخدمهاالمقايضة
filesystem MCPYou only need file read/write without controlling macOS appsMuch narrower scope but no system-level access risks

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills