MCP ExplorerExplorer

Mcp Server Apple Shortcuts

@recursechaton 20 days ago
175 Apache-2.0
FreeCommunity
AI Systems
The Apple Shortcuts MCP server enables AI assistants like Claude to control Apple Shortcuts automations on macOS. It allows listing and executing shortcuts with parameters, providing a safe and user-friendly interface for task automation.

Overview

What is Mcp Server Apple Shortcuts

mcp-server-apple-shortcuts is a Model Context Protocol (MCP) server that allows AI assistants like Claude to control Apple Shortcuts automations on macOS, enabling safe and controlled task automation.

Use cases

Use cases include automating daily tasks, triggering specific shortcuts through voice commands, and integrating AI assistance into personal workflows on macOS.

How to use

To use mcp-server-apple-shortcuts, ensure you have Node.js (v18 or higher) and Claude Desktop installed on macOS. Configure Claude Desktop with the provided JSON configuration and run the server using the specified commands.

Key features

Key features include the ability for AI assistants to list available shortcuts, run shortcuts by name with optional input parameters, and a simple interface for automation control.

Where to use

undefined

Content

Apple Shortcuts MCP Server 🤖

A Model Context Protocol (MCP) server that lets AI assistants like Claude control Apple Shortcuts automations. This enables AI models to trigger shortcuts and automate tasks on macOS in a safe and controlled way.

What is MCP? 🤔

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

What does this server do? 🚀

The 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

Prerequisites 📋

Before you begin, ensure you have:

Configuration to use Apple Shortcuts Server ⚙️

Here’s the Claude Desktop configuration to use the Apple Shortcuts server:

{
  "mcpServers": {
    "apple-shortcuts": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-apple-shortcuts"
      ]
    }
  }
}

Build Apple Shortcuts Server and run locally 🛠️

  1. Clone this repository:
git clone [email protected]:recursechat/mcp-server-apple-shortcuts.git
  1. Install dependencies:
npm install
  1. Build project
npm run build

Here’s the Claude Desktop configuration to use the Apple Shortcuts server with a local build:

Usage 🎯

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

License ⚖️

Apache-2.0

Tools

No tools

Comments