Apple Shortcuts MCP Server logo

Apple Shortcuts MCP Server

by MCP-Mirror

This server enables AI assistants like Claude to control Apple Shortcuts automations. It provides a safe and controlled way for AI models to trigger shortcuts and automate tasks on macOS.

View on GitHub

Last updated: N/A

What is Apple Shortcuts MCP Server?

The Apple Shortcuts MCP server is a Model Context Protocol (MCP) server that allows AI apps, such as Claude Desktop, to interact with and control Apple Shortcuts on macOS. It acts as a bridge, enabling AI to trigger shortcuts and automate tasks.

How to use Apple Shortcuts MCP Server?

To use this server, you need to configure Claude Desktop with the provided JSON configuration. This configuration specifies the command and arguments needed to run the server, either using the globally installed package or a local build. Once configured, you can ask Claude to list available shortcuts or run specific shortcuts by name.

Key features of Apple Shortcuts MCP Server

  • Enables AI assistants to list available shortcuts

  • Allows running shortcuts by name with optional input parameters

  • Provides a simple interface for automation control

  • Uses the Model Context Protocol (MCP) for secure AI interaction

Use cases of Apple Shortcuts MCP Server

  • Automating repetitive tasks on macOS using AI

  • Integrating AI assistants with Apple Shortcuts workflows

  • Controlling smart home devices through AI commands

  • Creating custom AI-powered automations using shortcuts

FAQ from Apple Shortcuts MCP Server

What is MCP?

The Model Context Protocol (MCP) is a system that lets AI apps connect to external tools and data sources. It provides a clear and safe way for AI assistants to work with local services and APIs while keeping the user in control.

What are the prerequisites for using this server?

You need Node.js (v18 or higher), Claude Desktop installed, and macOS with the Shortcuts app configured.

How do I configure Claude Desktop to use this server?

You need to add a configuration block to your Claude Desktop settings that specifies the command and arguments to run the server. Example configurations are provided in the README.

Can I run the server locally?

Yes, you can clone the repository, install dependencies, build the project, and then configure Claude Desktop to use the local build.

What kind of commands can I give to Claude?

You can ask Claude to "list shortcuts" or run a specific shortcut with the shortcut name, for example "get word of the day" or "play a song".