osascript MCP Server
Provides programmatic control over the Apple application ecosystem, including native apps like Music, Calendar, and Safari via AppleScript and JXA.
Facilitates the execution of curl commands via shell scripts to interact with web APIs and remote servers.
Supports JavaScript for Automation (JXA), allowing the use of JavaScript to control macOS applications and system resources.
Allows for the automation of macOS system tasks, including file management via Finder and simulating user input through System Events.
Enables scripted interaction with the Safari browser to perform tasks such as retrieving the URL of the current active tab.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@osascript MCP ServerGet the URL and title of my active Safari tab"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
osascript MCP Server
macOS の osascript(AppleScript / JavaScript for Automation)を実行できる MCP サーバーです。
特徴
AppleScript サポート: macOS のネイティブ AppleScript を実行
JXA サポート: JavaScript for Automation(JXA)を実行
安全設計: ファイル削除コマンドのみブロック(その他は全て許可)
Desktop Extension 対応: .mcpb 形式でワンクリックインストール
Related MCP server: macOS GUI Control MCP
インストール
方法 1: MCPB ファイルから(推奨)
.mcpbファイルをダウンロードClaude Desktop にドラッグ&ドロップ
インストールを許可
方法 2: 手動設定
Claude Desktop の設定ファイル(~/Library/Application Support/Claude/claude_desktop_config.json)に追加:
{
"mcpServers": {
"osascript": {
"command": "node",
"args": ["/path/to/osascript-mcp/server/index.js"],
"env": {
"OSASCRIPT_TIMEOUT": "30000",
"OSASCRIPT_LOG_SCRIPTS": "true"
}
}
}
}使用方法
AppleScript の実行
tell application "Finder" to get name of every diskJXA(JavaScript)の実行
Application("System Events").processes().map(p => p.name())許可される操作
以下の操作は全て許可されています:
シェルコマンド(削除以外)
do shell script "ls -la ~/Desktop"
do shell script "whoami"
do shell script "curl -s https://api.github.com"
do shell script "cat ~/.zshrc"Finder 操作
tell application "Finder" to get name of every disk
tell application "Finder" to get every file of desktop
tell application "Finder" to open folder "Documents" of homeSystem Events
tell application "System Events" to get name of every process
tell application "System Events" to keystroke "hello"
tell application "System Events" to key code 36 -- Enterアプリケーション制御
tell application "Safari" to get URL of current tab of window 1
tell application "Music" to get name of current track
tell application "Calendar" to get events of calendar 1ブロックされる操作
以下の削除操作のみがブロックされます:
シェルでの削除
-- これらはブロックされます
do shell script "rm test.txt"
do shell script "rm -rf ~/test"
do shell script "rmdir testdir"Finder での削除
-- これらはブロックされます
tell application "Finder" to delete file "test.txt" of desktop
move file "test.txt" to trash
empty trash設定オプション
オプション | 説明 | デフォルト |
| スクリプト実行タイムアウト(ミリ秒) | 30000 |
| スクリプトをログ出力するか | true |
開発
ビルド
# 依存関係インストール
npm install
# ローカルテスト
npm start
# MCPB パッケージ作成
npm install -g @anthropic-ai/mcpb
mcpb validate manifest.json
mcpb pack .テスト
# 許可されるスクリプトのテスト
echo 'tell application "Finder" to get name of every disk' | node server/index.js
# サーバーの直接実行(デバッグ用)
node server/index.jsセキュリティ
このサーバーは「最小限のセキュリティ」設計を採用しています:
✅ 許可: シェルコマンド(
ls,curl,catなど)✅ 許可: System Events(
keystroke,key code)✅ 許可: 全アプリケーションの制御
❌ ブロック:
rm,delete,trashなどの削除操作
より厳格なセキュリティが必要な場合は、server/index.js の BLOCKED_PATTERNS を編集してください。
ライセンス
MIT
関連リンク
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Tools
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables LLM applications to interact with macOS through AppleScript.Last updated3345393MIT
- AlicenseAqualityDmaintenanceEnables comprehensive control over macOS GUI elements including mouse, keyboard, window management, and screen capture. It allows for automated system interactions and script execution while maintaining safety by blocking potentially destructive deletion commands.Last updated19245MIT
- AlicenseAqualityCmaintenanceEnables Large Language Models to automate macOS applications and execute AppleScript commands through natural language. It features built-in security protections including application allowlists and dangerous pattern detection to prevent unauthorized or risky system operations.Last updated2MIT
- Alicense-qualityFmaintenanceEnables AI to dynamically discover and control native macOS applications (like Finder, Mail, Safari) through AppleScript/JXA automation without pre-built integrations.Last updated3MIT
Related MCP Connectors
Let ChatGPT, Claude & Cursor use your Mac: email, calendar, iMessage, Teams, files. Local, free.
Automate eSignature workflows and signing tasks via natural language commands.
Runtime permission, approval, and audit layer for AI agent tool execution.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Akira-Papa/osascript-MCP-1'
If you have feedback or need assistance with the MCP directory API, please join our Discord server