Build macOS automation with Shortcuts
system-engineersubagentsetup L2★1
amargautam/macOS-local-mcp-server ↗What it does
Build macOS Finder, Spotlight, and Shortcuts system tools
Best for
Integrating native macOS system capabilities (Spotlight search via mdfind, file metadata via mdls, Finder tags via xattr, Shortcuts automation) into Swift tools via test-driven patterns.
Inputs
- · Swift tool specifications
- · system API requirements
Outputs
- · FinderTool.swift
- · SpotlightBridge.swift
- · ShortcutsTool.swift
- · ShellBridge.swift
Requires
- · mdfind
- · mdls
- · xattr
- · shortcuts CLI
- · Process API
Preconditions
- · Xcode 14+
- · Swift 5.7+
- · macOS 13.0+
Failure modes
- · mdfind timeout if Spotlight indexing incomplete
- · Shortcuts app not running if CLI fails
Trust signals
- · TDD discipline (tests first, then implementation)
- · Protocol conformance (FinderProviding, ShortcutsProviding)
- · Mock-friendly shell bridge
- · Swift test runner validation