AppleScript MCP
Run AppleScript code to interact with Mac applications and system features. This tool can access and manipulate data in Notes, Calendar, Contacts, Messages, Mail, Finder, Safari, and other Apple appli
What is AppleScript MCP?
AppleScript MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to run applescript code to interact with mac applications and system features. this tool can access and manipulate data in notes, calendar, contacts, messages, mail, finder, safari, and other apple appli
Run AppleScript code to interact with Mac applications and system features. This tool can access and manipulate data in Notes, Calendar, Contacts, Messages, Mail, Finder, Safari, and other Apple appli
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- applescript_execute
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 MCP
AppleScript MCP is a macOS-only MCP server that exposes a rich set of automation tools for controlling Mac applications through AppleScript, covering Calendar, Clipboard, Finder, Mail, Messages, Notes, Pages, Shortcuts, System settings, and iTerm. It lets AI assistants like Claude create calendar events, search files, compose emails, manage notes, send notifications, control system volume, and more — all through natural language without manual scripting. Mac power users and developers use it to automate tedious desktop workflows directly from their AI client.
Prerequisites
- macOS 10.15 (Catalina) or later
- Node.js 18 or later
- Claude Desktop or another MCP-compatible client
- Full Disk Access permission granted to your terminal or Claude for Messages app access (in System Settings > Privacy & Security)
Install the package via npx
The easiest way to use this server is via npx, which runs the latest published version without a global install. Add it directly to your Claude Desktop configuration.
npx -y @peakmojo/applescript-mcpAdd to Claude Desktop configuration
Open your claude_desktop_config.json and add the applescript-mcp server. The npx command fetches and runs the package automatically each session.
{
"mcpServers": {
"applescript-mcp": {
"command": "npx",
"args": ["-y", "@peakmojo/applescript-mcp"]
}
}
}Grant required macOS permissions
AppleScript automation requires explicit permissions. Open System Settings > Privacy & Security > Automation and enable access for Claude (or Terminal) to control the apps you want to use. For Messages access, also enable Full Disk Access.
Restart Claude Desktop
Quit and reopen Claude Desktop to load the MCP server. The applescript_execute tool (and all app-specific tools) should now appear as available capabilities.
Test with a simple automation
Ask Claude to send a system notification to verify the server is working. This test does not require any special permissions beyond what is granted by default.
AppleScript MCP Examples
Client configuration
Claude Desktop configuration using npx to run the @peakmojo/applescript-mcp package. No environment variables are required.
{
"mcpServers": {
"applescript-mcp": {
"command": "npx",
"args": ["-y", "@peakmojo/applescript-mcp"]
}
}
}Prompts to try
These prompts demonstrate the range of Mac automation available through the AppleScript MCP server.
- "Create a calendar event titled 'Team Standup' tomorrow at 9am for 30 minutes"
- "Search my Documents folder for all PDF files and list their names"
- "Compose an email to [email protected] with subject 'Project Update' and a brief summary"
- "Send me a notification saying 'Time for a break' in 25 minutes"
- "Set my Mac volume to 40%"
- "List my Messages conversations from today"
- "Create a new note titled 'Meeting Notes' with today's date and a blank bullet list"
- "Run the 'Daily Backup' Shortcut"Troubleshooting AppleScript MCP
AppleScript permission denied errors when controlling apps
Open System Settings > Privacy & Security > Automation and ensure your terminal application or Claude has permission to control the specific app. You may need to toggle the permission off and on again if it was previously denied.
Messages tools fail or return empty results
Messages access requires Full Disk Access. Go to System Settings > Privacy & Security > Full Disk Access and add Terminal (or the process running the MCP server). Restart Claude Desktop after granting access.
npx fails to find or run @peakmojo/applescript-mcp
Ensure your Node.js version is 18 or later (`node --version`). Try running `npx -y @peakmojo/applescript-mcp` directly in a terminal to see the error output. If the package is not found, clear the npx cache with `npx clear-npx-cache`.
Frequently Asked Questions about AppleScript MCP
What is AppleScript MCP?
AppleScript MCP is a Model Context Protocol (MCP) server that run applescript code to interact with mac applications and system features. this tool can access and manipulate data in notes, calendar, contacts, messages, mail, finder, safari, and other apple appli It connects AI assistants to external tools and data sources through a standardized interface.
How do I install AppleScript MCP?
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 MCP?
AppleScript MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is AppleScript MCP free to use?
Yes, AppleScript MCP is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
AppleScript MCP Alternatives — Similar Developer Tools Servers
Looking for alternatives to AppleScript MCP? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up AppleScript MCP 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 MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.