applescript-mcp MCP Server

This is a Model Context Protocol server that allows LLM applications to interact with macOS via AppleScript, providing a standardized interface for AI control of system functions.

Features

• Calendar management (events, reminders)
• Clipboard operations
• Finder integration
• System notifications
• System controls (volume, dark mode, apps)
• iTerm terminal integration

Planned Features

• Mail, Safari, Messages, Reminders, Notes

Prerequisites

• macOS 10.15+
• Node.js 18+

Available Categories

Provides tables detailing commands, descriptions, and parameters for Calendar, Clipboard, Finder, Notifications, System, and iTerm.

Development

Adding New Functionality

Details steps to create a category file, add scripts, and register the category.

Debugging

Using MCP Inspector

Instructions for using the MCP Inspector for testing and debugging.

Logging

Enables debug logging via DEBUG=applescript-mcp* npm start.

Common Issues

Troubleshooting tips for permission errors, script failures, and communication issues.

Resources

Links to AppleScript Language Guide, MCP Protocol Documentation, and Issue Tracker.

Contributing

Guidelines for contributing to the project.

License

MIT License.