explainx.aijoin newsletter3.01k
productivitydeveloper-tools

Apple Shortcuts Server▌

by recursechat

Apple Shortcuts Server — seamless Shortcuts automation and Shortcuts integration for MCP servers. Trigger workflows, run

An MCP Server Integration with Apple Shortcuts

github stars

★ 311

GitHubnpm
macOS onlyWorks with existing Shortcuts

best for

  • / macOS users with existing Shortcuts workflows
  • / Automating repetitive tasks through AI conversation
  • / Integrating AI assistants with macOS system functions

capabilities

  • / List available Apple Shortcuts
  • / Run shortcuts by name
  • / Pass input parameters to shortcuts
  • / Control macOS automations via AI chat

what it does

Connects AI assistants like Claude to Apple Shortcuts, allowing them to list and run your macOS shortcuts automations. Provides a bridge between AI models and your existing macOS automation workflows.

about

Apple Shortcuts Server is a community-built MCP server published by recursechat that provides AI assistants with tools and capabilities via the Model Context Protocol. Apple Shortcuts Server — seamless Shortcuts automation and Shortcuts integration for MCP servers. Trigger workflows, run It is categorized under productivity, developer tools. This server exposes 2 tools that AI clients can invoke during conversations and coding sessions.

how to install

You can install Apple Shortcuts Server in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.

license

Apache-2.0

Apple Shortcuts Server is released under the Apache-2.0 license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

readme

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.

<a href="https://www.npmjs.com/package/mcp-server-apple-shortcuts"><img src="https://img.shields.io/npm/v/mcp-server-apple-shortcuts"/></a>

<a href="https://glama.ai/mcp/servers/15z6abk6p2"><img width="380" height="200" src="https://glama.ai/mcp/servers/15z6abk6p2/badge" /></a>

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 git@github.com: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:

{
  "mcpServers": {
    "apple-shortcuts": {
      "command": "npx",
      "args": ["/path/to/mcp-server-apple-shortcuts/build/index.js"],
    }
  }
}
<!-- ```json { "mcpServers": { "apple-shortcuts": { "command": "npx", "args": ["-y", "mcp-server-apple-shortcuts"] } } } ``` -->

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