AppleScript
Summary
This AppleScript MCP framework, developed by Josh Rutkowski, enables seamless integration of AppleScript capabilities with the Model Context Protocol. It leverages TypeScript and the MCP SDK to provide a robust interface for interacting with macOS applications and system functions through natural language. The implementation is designed for developers looking to incorporate AI-driven automation and control of macOS environments, making it particularly useful for creating intelligent assistants, workflow automation tools, or AI-enhanced macOS applications. Its focus on AppleScript integration sets it apart by offering unique access to macOS-specific functionality within the MCP ecosystem.
Available Actions(32)
add
Create calendar event. Parameters: title (string), startDate (string), endDate (string), calendar (optional string)
list
List today's events. Parameters: None
set_clipboard
Copy to clipboard. Parameters: content (string)
get_clipboard
Get clipboard contents. Parameters: None
clear_clipboard
Clear clipboard. Parameters: None
get_selected_files
Get selected files. Parameters: None
search_files
Search for files. Parameters: query (string), location (optional string)
quick_look
Preview file. Parameters: path (string)
send_notification
Show notification. Parameters: title (string), message (string), sound (optional string)
toggle_do_not_disturb
Toggle DND mode. Parameters: None
volume
Set system volume. Parameters: level (integer, 0-100)
get_frontmost_app
Get active app. Parameters: None
launch_app
Open application. Parameters: name (string)
quit_app
Close application. Parameters: name (string), force (optional boolean)
toggle_dark_mode
Toggle dark mode. Parameters: None
paste_clipboard
Paste to iTerm. Parameters: None
run
Execute command in iTerm. Parameters: command (string), newWindow (optional boolean)
run_shortcut
Run a shortcut. Parameters: name (string), input (optional string)
list_shortcuts
List all available shortcuts. Parameters: limit (optional integer)
create_email
Create a new email in Mail.app. Parameters: recipient (string), subject (string), body (string)
list_emails
List emails from a mailbox. Parameters: mailbox (optional string), count (optional integer), unreadOnly (optional boolean)
get_email
Get a specific email by search. Parameters: subject (optional string), sender (optional string), dateReceived (optional string), mailbox (optional string), account (optional string), unreadOnly (optional boolean), includeBody (optional boolean)
list_chats
List available iMessage and SMS chats. Parameters: includeParticipantDetails (optional boolean, default: false)
get_messages
Get messages from the Messages app. Parameters: limit (optional integer, default: 100)
search_messages
Search for messages containing specific text. Parameters: searchText (string), sender (optional string), chatId (optional string), limit (optional integer, default: 50), daysBack (optional integer, default: 30)
compose_message
Open Messages app with pre-filled message or auto-send. Parameters: recipient (string), body (optional string), auto (optional boolean, default: false)
create
Create a note with markdown-like formatting. Parameters: title (string), content (string), format (optional string)
createRawHtml
Create a note with direct HTML content. Parameters: title (string), html (string)
list
List notes, optionally from a specific folder. Parameters: folder (optional string)
get
Get a specific note by title. Parameters: title (string), folder (optional string)
search
Search for notes containing specific text. Parameters: query (string), folder (optional string), limit (optional integer, default: 5), includeBody (optional boolean, default: true)
create_document
Create a new Pages document with plain text. Parameters: content (string)
Community Reviews
No reviews yet. Be the first to review!
Sign in to join the conversation
