MCP.Market

Osascript MCP server

by m0rvayne·io.github.m0rvayne/mcp-osascript·v1.1.3·12 stars
No reviews yet

macOS automation: 17 typed tools for windows, menus, keyboard, clipboard, tabs, screenshots

A88/100grade A
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
A88/100

full report

Adoption
Growing

12 stars27 downloads/wk

Reviews

Write one

Nobody has reviewed Osascript yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Osascript tools (17, 3 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • app_menu

    List available menu items or click a specific menu item in an application. Requires Accessibility permission.

  • app_visibility

    Hide, unhide (show), or quit an application. Hiding keeps the app running but removes its windows from view (like Cmd+H). Requires Accessibility permission for hide/unhide.

  • file_open

    Open a file or folder, optionally in a specific application. Uses macOS 'open' command.

  • get_browser_tabs

    List open tabs in Safari, Chrome, or Arc (title + URL for each tab).

  • get_clipboard

    Get the current macOS clipboard contents as plain text.

  • get_displays

    Get information about all connected displays — position, size, and which is the main display. Useful for multi-monitor window management.

  • get_frontmost_app

    Get the name and bundle ID of the frontmost (active) application. May require Automation permission for System Events in System Settings > Privacy & Security > Automation.

  • manage_windows

    List, move, resize, minimize, fullscreen, or close application windows. For multi-monitor setups call get_displays first, then pass absolute coordinates to 'move'. Requires Accessibility permission for most actions.

  • open_app

    Launch or activate a macOS application by name.

  • open_url

    Open a URL in the default browser. Only http, https, and mailto schemes are allowed.

  • press_key

    Press a key with optional modifiers (e.g. return, tab, c with command). Requires Accessibility permission.

  • run_osascriptwrite action

    Execute an AppleScript or JXA (JavaScript for Automation) script on macOS.

  • run_shortcutwrite action

    List available Apple Shortcuts or run a specific shortcut by name.

  • screenshot

    Capture a screenshot of the full screen, a region, or a specific app window. Requires Screen Recording permission in System Settings > Privacy & Security > Screen Recording.

  • send_notificationwrite action

    Display a macOS notification banner with a title and message.

  • set_clipboard

    Set the macOS clipboard to the given text content.

  • type_text

    Type text into the frontmost application. Works by temporarily replacing the clipboard and pressing Cmd+V (not keystroke, which would garble non-Latin keyboard layouts). The previous clipboard is restored only if it held plain text — image or file clipboards are lost. Requires Accessibility permission. Max 500 chars.

Public scan report

scanner v0.1.10 · 2026-10-15 · same rubric, same numbers if you re-run it

no findings
  • Code scan3 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 34 days ago12/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 88/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Osascript compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
88/100
higher than 75% of 48,243 servers
Tools
17
the typical server has 7
Tools that change things
18%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
12
more than 89% of 28,706 servers
Downloads a week
27
more than 14% of 12,306 servers with a package

What its tools let an agent do: 11 read · 2 create · 1 change · 1 send or post · 2 run or deploy

Install Osascript in Claude Code, Cursor or VS Code

Runs npx -y mcp-osascript on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add mcp-osascript -- npx -y mcp-osascript
Add to Cursor

What the publisher says

From the Osascript repository's README, as published. We do not edit it. Read it on GitHub

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

Quick Start

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.

Config for other clients (Cursor, VS Code, Claude Code)

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"]

Try These Prompts

Once installed, ask Claude:

Tools

18 typed tools, each with input validation, error classification, and permission-aware error messages.

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Osascript: common questions

Is Osascript MCP server safe?
Yes, by our scan: it is graded A (88/100). Read the Osascript safety report
How do I install Osascript?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Osascript need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Osascript maintained?
The last commit was 55 days ago (2026-09-11). The latest release is v1.1.3.
How does Osascript compare with other MCP servers?
safety score 88/100 (higher than 75% of 48,243 servers); tools 17 (the typical server has 7); tools that change things 18% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.