https://github.com/recursechat/mcp-server-apple-shortcuts
https://github.com/recursechat/mcp-server-apple-shortcuts
Last synced: 13 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/recursechat/mcp-server-apple-shortcuts
- Owner: recursechat
- License: apache-2.0
- Created: 2024-12-11T20:32:57.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-12-19T17:47:03.000Z (4 months ago)
- Last Synced: 2024-12-19T18:36:11.623Z (4 months ago)
- Language: JavaScript
- Size: 14.6 KB
- Stars: 18
- Watchers: 1
- Forks: 4
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-list - @recursechat/mcp-server-apple-shortcuts - server-apple-shortcuts?style=social)](https://github.com/recursechat/mcp-server-apple-shortcuts): Integrates with macOS Shortcuts for automation via MCP. (Uncategorized / Uncategorized)
- awesome-mcp-zh - recursechat/mcp-server-apple-shortcuts
- awesome-mcp-servers - @recursechat/mcp-server-apple-shortcuts - An MCP Server Integration with Apple Shortcuts (Legend / 📂 <a name="browser-automation"></a>Browser Automation)
- awesome-mcp-servers - @recursechat/mcp-server-apple-shortcuts - An MCP Server Integration with Apple Shortcuts (Legend / 📂 <a name="browser-automation"></a>Browser Automation)
- awesome-mcp-servers - Apple Shortcuts - An MCP Server Integration with Apple Shortcuts (Community Servers)
- awesome-mcp-servers - Apple Shortcuts - An MCP Server Integration with Apple Shortcuts (🤖 <a name="system-automation"></a>System Automation)
- Awesome-MCP-Servers-directory - Apple Shortcuts - An MCP Server Integration with Apple Shortcuts (System Automation)
- awesome-mcp-servers - Shortcuts MCP Server - Lets AI assistants control Apple Shortcuts automations on macOS (Table of Contents / System Automation)
- awesome-mcp-servers - Shortcuts MCP Server - Lets AI assistants control Apple Shortcuts automations on macOS (Table of Contents / System Automation)
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.
## 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:
- [Node.js](https://nodejs.org/) (v18 or higher)
- [Claude Desktop](https://claude.ai/download) installed
- macOS with Shortcuts app configured
## Configuration to use Apple Shortcuts Server ⚙️
Here's the Claude Desktop configuration to use the Apple Shortcuts server:
```json
{
"mcpServers": {
"apple-shortcuts": {
"command": "npx",
"args": ["-y", "mcp-server-apple-shortcuts"]
}
}
}
```
## Build Apple Shortcuts Server and run locally 🛠️
1. Clone this repository:
```sh
git clone [email protected]:recursechat/mcp-server-apple-shortcuts.git
```
2. Install dependencies:
```sh
npm install
```
3. Build project
```sh
npm run build
```
Here's the Claude Desktop configuration to use the Apple Shortcuts server with a local build:
```json
{
"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