GitHub Stats

    Stars

    201

    Forks

    19

    Release Date

    6/18/2025

    about two weeks ago

    Detailed Description

    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 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"],
        }
      }
    }
    

    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

    Star History

    Star History

    Dec 11Dec 24Jan 21Feb 24Mar 11Mar 29Apr 14May 3May 24Jun 11Jul 3050100150200
    Powered by MSeeP Analytics

    About the Project

    This app has not been claimed by its owner yet.

    Claim Ownership

    Receive Updates

    Security Updates

    Get notified about trust rating changes

    to receive email notifications.