launchd-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_servicesA | List launchd services from Args: label_filter: Optional substring filter for the service label. |
| print_serviceA | Print detailed state for a launchd target via Args: target: A launchd target, e.g. "system/com.apple.cfprefsd.xpc.daemon" or "gui/501/com.example.app". |
| kickstart_serviceA | Start or restart a service via Args:
target: A launchd target, e.g. "gui/501/com.example.app".
kill_existing: If true, pass |
| bootstrap_serviceA | Load a launchd plist into a domain via Args: domain_target: Domain like "system", "user/501", or "gui/501". plist_path: Absolute path to a LaunchAgent/LaunchDaemon plist. |
| bootout_serviceC | Unload or remove a service/domain via Args: target: Service or domain target accepted by launchctl bootout. |
| enable_serviceC | Enable a service via Args: service_target: Service target like "system/com.example.daemon" or "gui/501/com.example.agent". |
| disable_serviceA | Disable a service via Args: service_target: Service target like "system/com.example.daemon" or "gui/501/com.example.agent". |
| list_plistsB | List available launchd plist files from common locations. Args: scope: "all", "system", or "user". |
| create_or_update_python_taskA | Create/update a LaunchAgent from a Python script string and load it. Args: task_name: Human friendly task name. Will be sanitized for label suffix. python_script: Python source code to execute. label_prefix: Reverse-domain prefix (e.g. "link.igtm.launchd-mcp"). run_at_load: Whether to run immediately after load. start_interval_seconds: Optional StartInterval in seconds. start_calendar: Optional object/array for StartCalendarInterval. watch_paths_csv: Optional comma-separated list for WatchPaths. queue_directories_csv: Optional comma-separated list for QueueDirectories. working_directory: Optional WorkingDirectory. Defaults to task directory. python_bin: Optional python executable path. Defaults to python3 on PATH. extra_path_csv: Optional comma-separated PATH entries prepended in plist. keep_alive: Optional KeepAlive (bool or object). throttle_interval_seconds: Optional ThrottleInterval in seconds. process_type: Optional ProcessType (Background/Standard/Adaptive/Interactive). nice: Optional Nice value. umask: Optional octal umask like "022" or "0o022". hard_resource_limits: Optional HardResourceLimits object. replace_existing: If true, bootout existing service first. |
| remove_python_taskA | Unload and remove a task created by create_or_update_python_task. Args: task_name: The original task name. label_prefix: Reverse-domain prefix used for task label. delete_files: If true, remove script/plist/log files. |
| list_python_tasksA | List managed tasks matching Args: label_prefix: Reverse-domain prefix used for managed task labels. |
| get_python_task_logsA | Fetch per-task execution logs (stdout/stderr). Args: task_name: Optional original task name. If omitted, return logs for all matching tasks. label_prefix: Reverse-domain prefix used for managed task labels. lines: Number of tail lines to return from each log file. include_stdout: Include stdout logs. include_stderr: Include stderr logs. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 12 tools
The generic launchctl tools and the managed Python-task tools are clearly separated into distinct groups. There is minor potential confusion between bootstrap_service and create_or_update_python_task since both load a plist, but the descriptions clarify that one is a raw launchctl wrapper and the other is a higher-level task manager.
All tool names follow a consistent verb_noun snake_case pattern, such as list_services, kickstart_service, bootout_service, and create_or_update_python_task. The naming convention is uniform across both the generic launchctl operations and the managed Python-task operations.
With 12 tools, the server is well-scoped for its launchd administration purpose. The generic service lifecycle tools and the higher-level Python-task management tools each earn their place without unnecessary redundancy or bloat.
The server covers the full launchd lifecycle: listing, inspecting, loading, unloading, starting, enabling, and disabling services. The Python-task workflow adds create/update/remove/list/logs, providing complete coverage for both the low-level and high-level use cases.