AppleScript
A Model Context Protocol server that enables running AppleScript code to interact with Mac applications and system features including Notes, Calendar, Contacts, Messages, file management, and more.
What is AppleScript?
AppleScript is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol server that enables running applescript code to interact with mac applications and system features including notes, calendar, contacts, messages, file management, and more.
A Model Context Protocol server that enables running AppleScript code to interact with Mac applications and system features including Notes, Calendar, Contacts, Messages, file management, and more.
This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Model Context Protocol server that enables running AppleSc
Use Cases
Maintainer
Works with
Installation
NPM
npx -y @peakmojo/applescript-mcpManual Installation
npx -y @peakmojo/applescript-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use AppleScript
The AppleScript MCP Server lets AI assistants execute AppleScript code to control macOS applications and system features directly from conversation. It bridges Claude and other MCP clients to Mac-native apps such as Notes, Calendar, Contacts, Messages, and Finder, as well as system utilities like Spotlight, battery info, and media playback. This means you can ask an AI to create calendar events, search your files, send messages, or capture screenshots without leaving your chat interface.
Prerequisites
- macOS (AppleScript is a macOS-only technology)
- Node.js 16 or later, or Python 3.9+ with uv installed
- An MCP-compatible client such as Claude Desktop or Cursor
- Appropriate macOS permissions granted (Accessibility, Full Disk Access, Contacts, etc.) for the apps you want to control
Install via npx (Node.js path)
The easiest way to run the server is directly with npx without a separate install step.
npx @peakmojo/applescript-mcpAdd the server to your MCP client config
Open claude_desktop_config.json (or your client's equivalent config file) and add the applescript_execute server block.
{
"mcpServers": {
"applescript_execute": {
"command": "npx",
"args": ["-y", "@peakmojo/applescript-mcp"]
}
}
}Grant macOS permissions
Go to System Settings > Privacy & Security and grant Accessibility access to your terminal or MCP client application. Additional permissions (Contacts, Calendar, Full Disk Access) may be needed for specific features.
Restart your MCP client
Quit and reopen Claude Desktop (or your MCP client) so it picks up the new server configuration.
(Optional) Install via Python/uvx for development
If you prefer the Python runtime or want to contribute, install Homebrew's uv and run directly from the repo.
brew install uv
git clone https://github.com/peakmojo/applescript-mcp.git
cd applescript-mcp
uv run mcp-server-applescriptAppleScript Examples
Client configuration
Claude Desktop config using npx. No API keys required — the server runs locally and calls osascript on your Mac.
{
"mcpServers": {
"applescript_execute": {
"command": "npx",
"args": ["-y", "@peakmojo/applescript-mcp"]
}
}
}Prompts to try
Example requests that use the AppleScript server to automate macOS apps and system features.
- "Create a calendar event called 'Team standup' for tomorrow at 9 AM"
- "Show me all notes that contain the word 'budget'"
- "Search my Mac for all PDF files modified this week"
- "Add John Smith with email [email protected] to my Contacts"
- "Take a screenshot and save it to my Desktop"
- "Check my battery level and available storage"Troubleshooting AppleScript
AppleScript execution fails with 'not allowed to send Apple events'
Go to System Settings > Privacy & Security > Automation and enable the relevant application permissions for your terminal or MCP client process. You may also need to add it under Accessibility.
npx command not found or server fails to start
Ensure Node.js 16+ is installed and npm/npx are on your PATH. Run node --version to verify. If using nvm, make sure the correct Node version is active in the shell that launches your MCP client.
Calendar or Contacts operations return permission errors
Open System Settings > Privacy & Security > Calendars (or Contacts) and grant access to the process running the MCP server (typically Terminal, iTerm2, or the MCP client application itself).
Frequently Asked Questions about AppleScript
What is AppleScript?
AppleScript is a Model Context Protocol (MCP) server that model context protocol server that enables running applescript code to interact with mac applications and system features including notes, calendar, contacts, messages, file management, and more. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install AppleScript?
Install via npm with the command: npx -y @peakmojo/applescript-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with AppleScript?
AppleScript works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is AppleScript free to use?
Yes, AppleScript is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
AppleScript Alternatives — Similar Browser Automation Servers
Looking for alternatives to AppleScript? Here are other popular browser automation servers you can use with Claude, Cursor, and VS Code.
Chrome DevTools MCP
★ 40.6kAI-powered Chrome automation server with natural language element detection. Control Chrome browser through MCP protocol for testing, debugging, and performance analysis. Features 91% accuracy in element location, works with free AI models, and suppo
UI TARS Desktop
★ 34.9k📇 🏠 - Browser automation capabilities using Puppeteer, both support local and remote browser connection.
Playwright
★ 32.8kA production-ready browser automation server that enables AI assistants to interact with web pages using tools for navigation, element interaction, and data extraction. It features a built-in Inspector UI and robust crash recovery for reliable automa
Page Agent
★ 18.0kJavaScript in-page GUI agent. Control web interfaces with natural language.
Chrome
★ 11.7kAn extension-based MCP server that enables AI assistants to control your browser, leveraging existing sessions and login states for automation and content analysis. It provides over 20 tools for semantic tab search, interactive element manipulation,
LAMDA
★ 7.8kThe most powerful Android RPA agent framework, next generation mobile automation.
Browse More Browser Automation MCP Servers
Explore all browser automation servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up AppleScript in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use AppleScript?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.