J
joshrutkowski/applescript-mcp
A macOS AppleScript MCP server
View on GitHub ↗Link checked 2026-11-12 · HTTP 200 · opens the vendor's own site
Install & config
Client config (built from the install command this repo gives)
{
"mcpServers": {
"joshrutkowski-applescript-mcp": {
"command": "npx",
"args": ["@modelcontextprotocol/inspector"]
}
}
}Parsed from the README we fetched on 2026-11-05; we have not executed it.
command/args come from the install command the repository states. When it is ambiguous, the project README wins.
VS Code (.vscode/mcp.json - the key is servers)
{
"servers": {
"joshrutkowski-applescript-mcp": {
"command": "npx",
"args": ["@modelcontextprotocol/inspector"]
}
}
}Same server, but VS Code keeps it under <code>servers</code>.
Claude Code (command line)
claude mcp add --transport stdio joshrutkowski-applescript-mcp -- npx @modelcontextprotocol/inspector
Claude Code does not read a config file; add the server with this command.
Key names differ by client: Clients & CLI
- Source
- collected from the abordage/awesome-mcp list · type: MCP server
- Harvest history
- first seen 2026-11-05 · last seen 2026-11-14 · seen 10× · listed by 10 sources
- Score
- score 1,003 · 10 sources · mcp
- Install
npx @modelcontextprotocol/inspector
FAQ (answers come from our records)
How do I install it?
The repository provides this install command:
npx @modelcontextprotocol/inspector. It comes from the repository itself; we cannot guarantee it runs as-is in your client.Who is it for?
We filed it under these tags: MCP 服务. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
first catalogued 2026-11-05；last seen 2026-11-14。There is no official certification or quality rating here — we record sources and dates only.
# applescript-mcp MCP Server
以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →
A Model Context Protocol server that enables LLM applications to interact with macOS through AppleScript.
This server provides a standardized interface for AI applications to control system functions, manage files, handle notifications, and more.
## Features
🗓️ Calendar management (events, reminders)
📋 Clipboard operations
🔍 Finder integration
🔔 System notifications
⚙️ System controls (volume, dark mode, apps)
📟 iTerm terminal integration
📬 Mail (create new email, list emails, get email)
🔄 Shortcuts automation
💬 Messages (list chats, get messages, search messages, send a message)
🗒️ Notes (create formatted notes, list notes, search notes)
📄 Pages (create documents)
### Planned Features
🧭 Safari (open in Safari, save page content, get selected page/tab)
✅ Reminders (create, get)
## Prerequisites
macOS 10.15 or later
Node.js 18 or later
## Available Categories
### Calendar
| Command | Description | Parameters |
| add | Create calendar event | title, startDate, endDate, calendar (optional) |
| list | List today's events | None |
#### Examples
// Create a new calendar event
Create a calendar event titled "Team Meeting" starting tomorrow at 2pm for 1 hour
// List today's events
What events do I have scheduled for today?
### Clipboard
| Command | Description | Parameters |
| setclipboard | Copy to clipboard | content |
| getclipboard | Get clipboard contents | None |
| clearclipboard | Clear clipboard | None |
#### Examples
// Copy text to clipboard
Copy "Remember to buy groceries" to my clipboard
// Get clipboard contents
What's currently in my clipboard?
// Clear clipboard
Clear my clipboard
### Finder
| Command | Description | Parameters |
| getselectedfiles | Get selected files | None |
| searchfiles | Search for files | query, location (optional) |
| quicklook | Preview file | path |
#### Examples
// Get selected files in Finder
What files do I currently have selected in Finder?
// Search for files
Find all PDF files in my Documents folder
// Preview a file
Show me a preview of ~/Documents/report.pdf
### Notifications
> Note: Sending notification requires that you enable notifications in System Settings > Notifications > Script Editor.
| Command | Description | Parameters |
| sendnotification | Show notification | title, message, sound (optional) |
| toggledonotdisturb | Toggle DND mode | None |
#### Examples
// Send a notification
Send me a notification with the title "Reminder" and message "Time to take a break"
// Toggle Do Not Disturb
Turn on Do Not Disturb mode
### System
| Command | Description | Parameters |
| volume | Set system volume | level (0-100) |
| getfrontmostapp | Get active app | None |
| launchapp | Open application | name |
| quitapp | Close application | name, force (optional) |
| toggledarkmode | Toggle dark mode | None |
#### Examples
// Set system volume
Set my Mac's volume to 50%
// Get active application
What app am I currently using?
// Launch an application
Open Safari
// Quit an application
Close Spotify
// Toggle dark mode
Switch to dark mode
### iTerm
| Command | Description | Parameters |
| pasteclipboard | Paste to iTerm | None |
| run | Execute command | command, newWindow (optional) |
#### Examples
// Paste clipboard to iTerm
This server provides a standardized interface for AI applications to control system functions, manage files, handle notifications, and more.
## Features
🗓️ Calendar management (events, reminders)
📋 Clipboard operations
🔍 Finder integration
🔔 System notifications
⚙️ System controls (volume, dark mode, apps)
📟 iTerm terminal integration
📬 Mail (create new email, list emails, get email)
🔄 Shortcuts automation
💬 Messages (list chats, get messages, search messages, send a message)
🗒️ Notes (create formatted notes, list notes, search notes)
📄 Pages (create documents)
### Planned Features
🧭 Safari (open in Safari, save page content, get selected page/tab)
✅ Reminders (create, get)
## Prerequisites
macOS 10.15 or later
Node.js 18 or later
## Available Categories
### Calendar
| Command | Description | Parameters |
| add | Create calendar event | title, startDate, endDate, calendar (optional) |
| list | List today's events | None |
#### Examples
// Create a new calendar event
Create a calendar event titled "Team Meeting" starting tomorrow at 2pm for 1 hour
// List today's events
What events do I have scheduled for today?
### Clipboard
| Command | Description | Parameters |
| setclipboard | Copy to clipboard | content |
| getclipboard | Get clipboard contents | None |
| clearclipboard | Clear clipboard | None |
#### Examples
// Copy text to clipboard
Copy "Remember to buy groceries" to my clipboard
// Get clipboard contents
What's currently in my clipboard?
// Clear clipboard
Clear my clipboard
### Finder
| Command | Description | Parameters |
| getselectedfiles | Get selected files | None |
| searchfiles | Search for files | query, location (optional) |
| quicklook | Preview file | path |
#### Examples
// Get selected files in Finder
What files do I currently have selected in Finder?
// Search for files
Find all PDF files in my Documents folder
// Preview a file
Show me a preview of ~/Documents/report.pdf
### Notifications
> Note: Sending notification requires that you enable notifications in System Settings > Notifications > Script Editor.
| Command | Description | Parameters |
| sendnotification | Show notification | title, message, sound (optional) |
| toggledonotdisturb | Toggle DND mode | None |
#### Examples
// Send a notification
Send me a notification with the title "Reminder" and message "Time to take a break"
// Toggle Do Not Disturb
Turn on Do Not Disturb mode
### System
| Command | Description | Parameters |
| volume | Set system volume | level (0-100) |
| getfrontmostapp | Get active app | None |
| launchapp | Open application | name |
| quitapp | Close application | name, force (optional) |
| toggledarkmode | Toggle dark mode | None |
#### Examples
// Set system volume
Set my Mac's volume to 50%
// Get active application
What app am I currently using?
// Launch an application
Open Safari
// Quit an application
Close Spotify
// Toggle dark mode
Switch to dark mode
### iTerm
| Command | Description | Parameters |
| pasteclipboard | Paste to iTerm | None |
| run | Execute command | command, newWindow (optional) |
#### Examples
// Paste clipboard to iTerm
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/joshrutkowski-applescript-mcp/)
- Source
- awesome · https://github.com/joshrutkowski/applescript-mcp
- Browse by field
- MCP servers
- Listed by
- 10 independent sources
- added
- today
More like this
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.