Siri Shortcuts MCP Server logo

Siri Shortcuts MCP Server

by dvcrn

This MCP server provides access to Siri shortcuts functionality via the Model Context Protocol (MCP). It allows listing, opening, and running shortcuts from the macOS Shortcuts app.

View on GitHub

Last updated: N/A

What is Siri Shortcuts MCP Server?

This server exposes macOS Siri Shortcuts to Large Language Models (LLMs) via the Model Context Protocol (MCP). It provides tools to list, open, and run shortcuts, enabling LLMs to leverage the functionality of the Shortcuts app.

How to use Siri Shortcuts MCP Server?

To use this server, add it to your Claude configuration as an MCP server, specifying the command and arguments to run the server. Then, the LLM can use the provided tools (list_shortcuts, open_shortcut, run_shortcut, and dynamically generated shortcut-specific tools) to interact with your Siri Shortcuts.

Key features of Siri Shortcuts MCP Server

  • Exposes all shortcuts available in the Shortcuts app

  • Provides tools to list, open, and run shortcuts

  • Dynamically generates tools for each available shortcut

  • Supports both direct text input and file-based input

Use cases of Siri Shortcuts MCP Server

  • Automating tasks on macOS via LLM prompts

  • Integrating Siri Shortcuts into LLM workflows

  • Creating custom tools for LLMs using Siri Shortcuts

  • Allowing LLMs to interact with macOS applications through Shortcuts

FAQ from Siri Shortcuts MCP Server

What is MCP?

Model Context Protocol (MCP) is a protocol that allows LLMs to interact with external tools and services.

How do I find the names of my shortcuts?

Use the list_shortcuts tool to retrieve a list of all available shortcut names.

What kind of input can I pass to a shortcut?

You can pass either direct text input or a filepath to a file containing the input.

How are shortcut names sanitized for dynamic tool names?

Shortcut names are sanitized to ensure compatibility with tool naming conventions.

Does this server support error handling?

Yes, the server implements standard MCP error handling.