macOS automation: 17 typed tools for windows, menus, keyboard, clipboard, tabs, screenshots
MCPpedia last refreshed this data
io.github.m0rvayne/mcp-osascript is an MCP server that macOS automation: 17 typed tools for windows, menus, keyboard, clipboard, tabs, screenshots. Its tool list has not been published yet over stdio, sse and http, requires no API key, and scores 83/100 on MCPpedia's security, maintenance and efficiency rubric.
Config is the same across clients - only the file and path differ.
{
"mcpServers": {
"osascript": {
"args": [
"-y",
"mcp-osascript"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
macOS automation: 17 typed tools for windows, menus, keyboard, clipboard, tabs, screenshots
Run this in your terminal to verify the server starts. Then let us know if it worked - your result helps other developers.
npx -y 'mcp-osascript' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories - click any category to see the underlying evidence.
No known CVEs.
Checked mcp-osascript against OSV.dev.
Click any tool to inspect its schema.
Be the first to review
Have you used this server?
Share your experience - it helps other developers decide.
Sign in to write a review.
Others in productivity
Official MCP server for Anytype API - your encrypted, local and collaborative wiki.
MCP server for monday.com integration.
Give AI agents access to your Obsidian vault via local files or Self-hosted LiveSync.
An MCP Server for computer-use in Windows OS
MCP Security Weekly
Get CVE alerts and security updates for io.github.m0rvayne/mcp-osascript and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
Let Claude control your Mac. Move windows, click menus, type text, read clipboard, manage browser tabs, take screenshots, run Shortcuts — 18 typed tools with input validation and security guardrails.
Listed in the official MCP Registry as io.github.m0rvayne/mcp-osascript

Claude Desktop — one click. Download mcp-osascript-1.1.3.mcpb from the latest release and double-click it. Claude Desktop installs the extension itself.
Or add it to the config manually:
{
"mcpServers": {
"osascript": {
"command": "npx",
"args": ["-y", "mcp-osascript"]
}
}
}
Add this to your Claude Desktop config (Settings → Developer → Edit Config), restart Claude, and you're ready.
Cursor / VS Code (Copilot)
{
"mcpServers": {
"osascript": {
"command": "npx",
"args": ["-y", "mcp-osascript"]
}
}
}
Claude Code
claude mcp add osascript -- npx -y mcp-osascript
From source (development)
git clone https://github.com/m0rvayne/mcp-osascript.git
cd mcp-osascript && npm install
# then use: "command": "node", "args": ["/path/to/mcp-osascript/server/index.js"]
Once installed, ask Claude:
| Prompt | What happens |
|---|---|
| "Open Safari and show me what tabs I have" | Launches Safari, reads all tab titles and URLs |
| "Move the Finder window to the left half of my screen" | Resizes and positions the window |
| "Click File → Export as PDF in Keynote" | Navigates the menu bar and clicks the item |
| "Copy the URL from my active Chrome tab" | Reads browser tabs, finds the active one |
| "Type 'Hello World' into the active text field" | Simulates keyboard input |
| "Show a notification when you're done" | Displays a native macOS banner |
| "What app am I using right now?" | Returns the frontmost app name and bundle ID |
| "Press Cmd+Shift+4" | Triggers the screenshot shortcut |
| "List all items in the Edit menu of VS Code" | Introspects the menu bar |
| "Close the second window of Terminal" | Targets a specific window by index |
| "Screenshot the Safari window and save it to my Desktop" | Captures just that window, not the whole screen |
| "Which monitor is my Slack window on?" | Reads display geometry and window positions |
| "Hide everything except my editor" | Hides apps without quitting them |
| "Run my 'Daily Standup' shortcut" | Invokes an Apple Shortcut by name |
18 typed tools, each with input validation, error classification, and permission-aware error messages.
| Tool | What it does | Permission |
|---|---|---|
check_permissions | Report which permissions are granted and what each unlocks | None |
run_osascript | Execute any AppleScript or JXA script | None |
get_clipboard | Read clipboard as text | None |
set_clipboard |