Apple Shortcuts Server

npmGitHub
  • OS Automation
JavaScript
Apache-2.0
18
  • Apple
A
security – no known vulnerabilities (report Issue)
A
license - permissive license (Apache-2.0)
A
quality - confirmed to work

An MCP Server Integration with Apple Shortcuts

  1. Tools
  2. Prompts
  3. Resources
  4. Server Configuration
  5. README.md

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription
Available Shortcuts

Tools

Functions exposed to the LLM to take actions

NameDescription
run_shortcutRun a Shortcuts automation by name
list_shortcutsList all available shortcuts

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Need Help?View Source CodeReport Issue
README.md

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 ⚙️

  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:

{ "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

GitHub Badge

Glama performs regular codebase and documentation scans to:

  • Confirm that the MCP server is working as expected.
  • Confirm that there are no obvious security issues with dependencies of the server.
  • Extract server characteristics such as tools, resources, prompts, and required parameters.

Our directory badge helps users to quickly asses that the MCP server is safe, server capabilities, and instructions for installing the server.

Copy the following code to your README.md file:

Alternative MCP servers

  • mcp-apple-notes

    -
    security
    F
    license
    -
    quality
    Enables semantic search and RAG (Retrieval Augmented Generation) over your Apple Notes.
    • Apple

  • mcp-virustotal

    A
    security
    A
    license
    A
    quality
    A MCP server for querying the [VirusTotal](https://www.virustotal.com/gui/home/upload) API. This server provides tools for scanning URLs, analyzing file hashes, and retrieving IP address reports.
    MIT
    • Apple