switch-parental-controls 0.1.0__tar.gz

switch_parental_controls-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Daniel Schroeder
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

switch_parental_controls-0.1.0/PKG-INFO

@@ -0,0 +1,219 @@
+Metadata-Version: 2.4
+Name: switch-parental-controls
+Version: 0.1.0
+Summary: Nintendo Switch Parental Controls
+License: MIT
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mcp[cli]>=1.0.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: pynintendoparental>=2.3.4
+Requires-Dist: aiohttp>=3.9.0
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.23.0; extra == "dev"
+Requires-Dist: ruff>=0.4.0; extra == "dev"
+Requires-Dist: python-dotenv>=1.0.0; extra == "dev"
+Dynamic: license-file
+
+# Nintendo Switch Parental Controls
+
+An [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that exposes Nintendo Switch Parental Controls as AI-accessible tools. It wraps the [`pynintendoparental`](https://github.com/pantherale0/pynintendoparental) library and allows AI assistants to monitor and manage parental control settings on Nintendo Switch devices.
+
+## Features
+
+- **Authentication**: Interactive Nintendo OAuth login flow via MCP tools, or pre-configured session token
+- **Device monitoring**: List devices, view playtime, remaining time, sync status
+- **Playtime controls**: Set daily limits, add extra time, configure per-day-of-week schedules
+- **Bedtime controls**: Set bedtime alarms and end times
+- **Restriction controls**: Set restriction mode (forced termination vs. alarm), content restriction levels
+- **Player tracking**: View player profiles and today's app usage
+- **Application management**: List apps, manage the allow-list (bypass content restrictions)
+
+## Prerequisites
+
+- [uv](https://docs.astral.sh/uv/) — install once, no Python or clone needed:
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+## Authentication: Getting Your Nintendo Session Token
+
+The server requires a Nintendo session token to access the Parental Controls API. You can obtain one in two ways:
+
+### Method 1: Interactive MCP Tool (Recommended for first-time setup)
+
+1. Start the MCP server (see below)
+2. Ask your AI assistant to call `nintendo_get_login_url`
+3. Open the returned URL in your browser
+4. Log in with your Nintendo Account
+5. On the "Select this person" page, **right-click** the "Select this person" button and copy the link
+6. Ask your AI assistant to call `nintendo_complete_login` with the copied URL
+7. The tool will return your session token — **save it!**
+
+### Method 2: Manual (if you already have a token)
+
+If you already have a session token, set it as an environment variable:
+
+```bash
+export NINTENDO_SESSION_TOKEN="your-token-here"
+```
+
+### Saving Your Token
+
+Once you have a session token, add it to your environment so you don't need to log in again:
+
+```bash
+# Add to your shell profile (~/.zshrc, ~/.bashrc, etc.)
+export NINTENDO_SESSION_TOKEN="your-token-here"
+
+# Or create a .env file (never commit this!)
+echo 'NINTENDO_SESSION_TOKEN=your-token-here' >> .env
+```
+
+> **Note**: Session tokens can expire. If you get authentication errors, repeat the login flow.
+
+## Running the Server
+
+```bash
+uvx --from switch-parental-controls mcp
+```
+
+No clone or install required — `uvx` fetches the package from PyPI and runs it in an isolated environment.
+
+### Environment Variables
+
+| Variable                 | Required | Default         | Description                             |
+| ------------------------ | -------- | --------------- | --------------------------------------- |
+| `NINTENDO_SESSION_TOKEN` | No\*     | —               | Nintendo session token                  |
+| `NINTENDO_TIMEZONE`      | No       | `Europe/London` | IANA timezone (e.g. `America/New_York`) |
+| `NINTENDO_LANG`          | No       | `en-GB`         | Language code (e.g. `en-US`)            |
+
+\*Required for any tool that accesses Nintendo data, unless you use the interactive login tools.
+
+### MCP Client Configuration
+
+Add to your MCP client configuration (e.g. Claude Desktop `claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "nintendo": {
+      "command": "uvx",
+      "args": ["--from", "switch-parental-controls", "mcp"],
+      "env": {
+        "NINTENDO_SESSION_TOKEN": "your-token-here",
+        "NINTENDO_TIMEZONE": "America/New_York",
+        "NINTENDO_LANG": "en-US"
+      }
+    }
+  }
+}
+```
+
+## Available Tools
+
+### Authentication
+
+| Tool                      | Description                                                   |
+| ------------------------- | ------------------------------------------------------------- |
+| `nintendo_get_login_url`  | Generate the Nintendo login URL and step-by-step instructions |
+| `nintendo_complete_login` | Complete login with the redirect URL from the browser         |
+
+### Devices
+
+| Tool                           | Description                                                 |
+| ------------------------------ | ----------------------------------------------------------- |
+| `nintendo_list_devices`        | List all Nintendo Switch devices on the account             |
+| `nintendo_get_device`          | Get detailed status for a specific device                   |
+| `nintendo_get_today_summary`   | Get today's usage summary for a device                      |
+| `nintendo_get_monthly_summary` | Get monthly usage summary (optionally for a specific month) |
+
+### Playtime Controls
+
+| Tool                                | Description                                               |
+| ----------------------------------- | --------------------------------------------------------- |
+| `nintendo_set_daily_playtime_limit` | Set the daily playtime limit (0-360 min, or -1 to remove) |
+| `nintendo_add_extra_time`           | Add extra playtime for today                              |
+| `nintendo_set_timer_mode`           | Switch between DAILY and EACH_DAY_OF_THE_WEEK modes       |
+| `nintendo_set_day_restrictions`     | Set per-day playtime and bedtime restrictions             |
+
+### Restriction Controls
+
+| Tool                                     | Description                              |
+| ---------------------------------------- | ---------------------------------------- |
+| `nintendo_set_restriction_mode`          | Set FORCED_TERMINATION or ALARM mode     |
+| `nintendo_set_content_restriction_level` | Set age-based content restrictions       |
+| `nintendo_set_bedtime_alarm`             | Set the bedtime alarm time (16:00-23:00) |
+| `nintendo_set_bedtime_end_time`          | Set when bedtime ends (05:00-09:00)      |
+
+### Players
+
+| Tool                    | Description                                    |
+| ----------------------- | ---------------------------------------------- |
+| `nintendo_list_players` | List all players on a device                   |
+| `nintendo_get_player`   | Get player details including apps played today |
+
+### Applications
+
+| Tool                          | Description                                               |
+| ----------------------------- | --------------------------------------------------------- |
+| `nintendo_list_applications`  | List all tracked applications on a device                 |
+| `nintendo_set_app_allow_list` | Add/remove an app from the content restriction allow-list |
+
+## Development
+
+Requires [mise](https://mise.jdx.dev/):
+
+```bash
+# Install dependencies
+mise run install
+
+# Run tests
+mise run test
+
+# Run linter
+mise run lint
+
+# Fix lint issues
+mise run lint-fix
+
+# Open MCP Inspector (browser UI to test tools interactively)
+mise run inspect
+```
+
+### MCP Inspector
+
+The `inspect` task launches the [MCP Inspector](https://github.com/modelcontextprotocol/inspector) — a browser-based UI for testing MCP tools interactively without needing a full AI client.
+
+```bash
+mise run inspect
+```
+
+This opens the inspector connected to the nintendo_mcp server. You can call any tool directly from the UI, which is useful for testing the authentication flow and verifying tool responses.
+
+### Testing with opencode locally
+
+An example opencode config is provided at [`opencode.jsonc.example`](./opencode.jsonc.example). To use it:
+
+```bash
+# 1. Copy the example config
+cp opencode.jsonc.example opencode.jsonc
+
+# 2. Optionally set NINTENDO_SESSION_TOKEN in opencode.jsonc
+
+# 3. Open opencode in this project directory — it will pick up the local config
+opencode
+```
+
+The local `opencode.jsonc` is gitignored so your session token stays private.
+
+## CI
+
+Tests run automatically on pull requests via GitHub Actions. See [`.github/workflows/test.yml`](.github/workflows/test.yml).
+
+## License
+
+MIT

switch_parental_controls-0.1.0/README.md

@@ -0,0 +1,200 @@
+# Nintendo Switch Parental Controls
+
+An [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that exposes Nintendo Switch Parental Controls as AI-accessible tools. It wraps the [`pynintendoparental`](https://github.com/pantherale0/pynintendoparental) library and allows AI assistants to monitor and manage parental control settings on Nintendo Switch devices.
+
+## Features
+
+- **Authentication**: Interactive Nintendo OAuth login flow via MCP tools, or pre-configured session token
+- **Device monitoring**: List devices, view playtime, remaining time, sync status
+- **Playtime controls**: Set daily limits, add extra time, configure per-day-of-week schedules
+- **Bedtime controls**: Set bedtime alarms and end times
+- **Restriction controls**: Set restriction mode (forced termination vs. alarm), content restriction levels
+- **Player tracking**: View player profiles and today's app usage
+- **Application management**: List apps, manage the allow-list (bypass content restrictions)
+
+## Prerequisites
+
+- [uv](https://docs.astral.sh/uv/) — install once, no Python or clone needed:
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+```
+
+## Authentication: Getting Your Nintendo Session Token
+
+The server requires a Nintendo session token to access the Parental Controls API. You can obtain one in two ways:
+
+### Method 1: Interactive MCP Tool (Recommended for first-time setup)
+
+1. Start the MCP server (see below)
+2. Ask your AI assistant to call `nintendo_get_login_url`
+3. Open the returned URL in your browser
+4. Log in with your Nintendo Account
+5. On the "Select this person" page, **right-click** the "Select this person" button and copy the link
+6. Ask your AI assistant to call `nintendo_complete_login` with the copied URL
+7. The tool will return your session token — **save it!**
+
+### Method 2: Manual (if you already have a token)
+
+If you already have a session token, set it as an environment variable:
+
+```bash
+export NINTENDO_SESSION_TOKEN="your-token-here"
+```
+
+### Saving Your Token
+
+Once you have a session token, add it to your environment so you don't need to log in again:
+
+```bash
+# Add to your shell profile (~/.zshrc, ~/.bashrc, etc.)
+export NINTENDO_SESSION_TOKEN="your-token-here"
+
+# Or create a .env file (never commit this!)
+echo 'NINTENDO_SESSION_TOKEN=your-token-here' >> .env
+```
+
+> **Note**: Session tokens can expire. If you get authentication errors, repeat the login flow.
+
+## Running the Server
+
+```bash
+uvx --from switch-parental-controls mcp
+```
+
+No clone or install required — `uvx` fetches the package from PyPI and runs it in an isolated environment.
+
+### Environment Variables
+
+| Variable                 | Required | Default         | Description                             |
+| ------------------------ | -------- | --------------- | --------------------------------------- |
+| `NINTENDO_SESSION_TOKEN` | No\*     | —               | Nintendo session token                  |
+| `NINTENDO_TIMEZONE`      | No       | `Europe/London` | IANA timezone (e.g. `America/New_York`) |
+| `NINTENDO_LANG`          | No       | `en-GB`         | Language code (e.g. `en-US`)            |
+
+\*Required for any tool that accesses Nintendo data, unless you use the interactive login tools.
+
+### MCP Client Configuration
+
+Add to your MCP client configuration (e.g. Claude Desktop `claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "nintendo": {
+      "command": "uvx",
+      "args": ["--from", "switch-parental-controls", "mcp"],
+      "env": {
+        "NINTENDO_SESSION_TOKEN": "your-token-here",
+        "NINTENDO_TIMEZONE": "America/New_York",
+        "NINTENDO_LANG": "en-US"
+      }
+    }
+  }
+}
+```
+
+## Available Tools
+
+### Authentication
+
+| Tool                      | Description                                                   |
+| ------------------------- | ------------------------------------------------------------- |
+| `nintendo_get_login_url`  | Generate the Nintendo login URL and step-by-step instructions |
+| `nintendo_complete_login` | Complete login with the redirect URL from the browser         |
+
+### Devices
+
+| Tool                           | Description                                                 |
+| ------------------------------ | ----------------------------------------------------------- |
+| `nintendo_list_devices`        | List all Nintendo Switch devices on the account             |
+| `nintendo_get_device`          | Get detailed status for a specific device                   |
+| `nintendo_get_today_summary`   | Get today's usage summary for a device                      |
+| `nintendo_get_monthly_summary` | Get monthly usage summary (optionally for a specific month) |
+
+### Playtime Controls
+
+| Tool                                | Description                                               |
+| ----------------------------------- | --------------------------------------------------------- |
+| `nintendo_set_daily_playtime_limit` | Set the daily playtime limit (0-360 min, or -1 to remove) |
+| `nintendo_add_extra_time`           | Add extra playtime for today                              |
+| `nintendo_set_timer_mode`           | Switch between DAILY and EACH_DAY_OF_THE_WEEK modes       |
+| `nintendo_set_day_restrictions`     | Set per-day playtime and bedtime restrictions             |
+
+### Restriction Controls
+
+| Tool                                     | Description                              |
+| ---------------------------------------- | ---------------------------------------- |
+| `nintendo_set_restriction_mode`          | Set FORCED_TERMINATION or ALARM mode     |
+| `nintendo_set_content_restriction_level` | Set age-based content restrictions       |
+| `nintendo_set_bedtime_alarm`             | Set the bedtime alarm time (16:00-23:00) |
+| `nintendo_set_bedtime_end_time`          | Set when bedtime ends (05:00-09:00)      |
+
+### Players
+
+| Tool                    | Description                                    |
+| ----------------------- | ---------------------------------------------- |
+| `nintendo_list_players` | List all players on a device                   |
+| `nintendo_get_player`   | Get player details including apps played today |
+
+### Applications
+
+| Tool                          | Description                                               |
+| ----------------------------- | --------------------------------------------------------- |
+| `nintendo_list_applications`  | List all tracked applications on a device                 |
+| `nintendo_set_app_allow_list` | Add/remove an app from the content restriction allow-list |
+
+## Development
+
+Requires [mise](https://mise.jdx.dev/):
+
+```bash
+# Install dependencies
+mise run install
+
+# Run tests
+mise run test
+
+# Run linter
+mise run lint
+
+# Fix lint issues
+mise run lint-fix
+
+# Open MCP Inspector (browser UI to test tools interactively)
+mise run inspect
+```
+
+### MCP Inspector
+
+The `inspect` task launches the [MCP Inspector](https://github.com/modelcontextprotocol/inspector) — a browser-based UI for testing MCP tools interactively without needing a full AI client.
+
+```bash
+mise run inspect
+```
+
+This opens the inspector connected to the nintendo_mcp server. You can call any tool directly from the UI, which is useful for testing the authentication flow and verifying tool responses.
+
+### Testing with opencode locally
+
+An example opencode config is provided at [`opencode.jsonc.example`](./opencode.jsonc.example). To use it:
+
+```bash
+# 1. Copy the example config
+cp opencode.jsonc.example opencode.jsonc
+
+# 2. Optionally set NINTENDO_SESSION_TOKEN in opencode.jsonc
+
+# 3. Open opencode in this project directory — it will pick up the local config
+opencode
+```
+
+The local `opencode.jsonc` is gitignored so your session token stays private.
+
+## CI
+
+Tests run automatically on pull requests via GitHub Actions. See [`.github/workflows/test.yml`](.github/workflows/test.yml).
+
+## License
+
+MIT

switch_parental_controls-0.1.0/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "switch-parental-controls"
+version = "0.1.0"
+description = "Nintendo Switch Parental Controls"
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.12"
+dependencies = [
+    "mcp[cli]>=1.0.0",
+    "pydantic>=2.0.0",
+    "pynintendoparental>=2.3.4",
+    "aiohttp>=3.9.0",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=8.0.0", "pytest-asyncio>=0.23.0", "ruff>=0.4.0", "python-dotenv>=1.0.0"]
+
+[project.scripts]
+mcp = "nintendo_mcp.server:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+asyncio_default_fixture_loop_scope = "module"
+testpaths = ["tests"]
+markers = ["integration: mark a test as an integration test requiring real Nintendo API credentials"]
+
+[tool.ruff]
+line-length = 120
+target-version = "py312"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP"]

switch_parental_controls-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

switch_parental_controls-0.1.0/src/nintendo_mcp/__init__.py

@@ -0,0 +1 @@
+"""Nintendo Switch Parental Controls MCP Server."""

switch_parental_controls-0.1.0/src/nintendo_mcp/__main__.py

@@ -0,0 +1,13 @@
+"""Entry point for running the Nintendo MCP server as a module.
+
+This file ensures the server is always imported as 'nintendo_mcp.server'
+(never as '__main__'), so tool registrations from all submodules land on
+the same FastMCP instance that gets served.
+
+Usage:
+    python -m nintendo_mcp
+"""
+
+from nintendo_mcp.server import main
+
+main()

switch_parental_controls-0.1.0/src/nintendo_mcp/applications.py

@@ -0,0 +1,181 @@
+"""Application tools for the Nintendo MCP server.
+
+Provides tools to read application information and manage the allow-list
+(safe launch settings) for games on Nintendo Switch devices.
+"""
+
+from mcp.server.fastmcp import Context
+from pynintendoparental.enum import SafeLaunchSetting
+
+from nintendo_mcp.models import DeviceInput, ResponseFormat, SetAppAllowListInput
+from nintendo_mcp.server import _state, mcp
+from nintendo_mcp.utils import format_minutes, handle_error, require_client, to_json
+
+
+def _app_to_dict(app) -> dict:
+    """Convert an Application object to a serializable dictionary."""
+    return {
+        "application_id": app.application_id,
+        "name": app.name,
+        "image_url": app.image_url,
+        "today_time_played_minutes": app.today_time_played,
+        "allow_list_status": str(app.safe_launch_setting),
+    }
+
+
+@mcp.tool(
+    name="nintendo_list_applications",
+    annotations={
+        "title": "List Applications on Device",
+        "readOnlyHint": True,
+        "destructiveHint": False,
+        "idempotentHint": True,
+        "openWorldHint": True,
+    },
+)
+async def nintendo_list_applications(params: DeviceInput, ctx: Context) -> str:
+    """List all applications (games) tracked on a Nintendo Switch device.
+
+    Returns all games and applications that have been played on the device,
+    including their names, today's playtime, and allow-list status.
+
+    The allow-list status indicates whether an application can bypass content
+    restrictions (ALLOW) or is subject to normal restrictions (NONE).
+
+    Args:
+        params (DeviceInput): Validated input containing:
+            - device_id (str): The unique device ID (from nintendo_list_devices).
+            - response_format (str): 'markdown' or 'json' (default: 'markdown').
+
+    Returns:
+        str: List of applications with their status, or an error message.
+
+        Success response (JSON):
+        {
+            "count": int,
+            "device_name": str,
+            "applications": [
+                {
+                    "application_id": str,
+                    "name": str,
+                    "image_url": str,
+                    "today_time_played_minutes": int,
+                    "allow_list_status": str   # "NONE" or "ALLOW"
+                }
+            ]
+        }
+
+    Error Handling:
+        - Returns "Error: Not authenticated..." if no session token is configured.
+        - Returns "No applications found..." if no apps have been tracked.
+    """
+    err = require_client(_state.get("client"))
+    if err:
+        return err
+
+    try:
+        client = _state["client"]
+        device = client.devices.get(params.device_id)
+        if device is None:
+            return (
+                f"Error: Device '{params.device_id}' not found. "
+                "Use nintendo_list_devices to see available device IDs."
+            )
+
+        await device.update()
+        apps = list(device.applications.values())
+
+        if not apps:
+            return f"No applications tracked on device '{device.name}'."
+
+        if params.response_format == ResponseFormat.JSON:
+            return to_json(
+                {
+                    "count": len(apps),
+                    "device_name": device.name,
+                    "applications": [_app_to_dict(a) for a in apps],
+                }
+            )
+
+        lines = [f"# Applications on {device.name}", ""]
+        for app in apps:
+            allow_status = str(app.safe_launch_setting)
+            allow_label = "✓ Allow-listed" if allow_status == "ALLOW" else "Normal restrictions"
+            lines.append(f"## {app.name}")
+            lines.append(f"- **App ID**: `{app.application_id}`")
+            lines.append(f"- **Today's playtime**: {format_minutes(app.today_time_played)}")
+            lines.append(f"- **Allow-list**: {allow_label}")
+            lines.append("")
+        return "\n".join(lines)
+
+    except Exception as e:
+        return handle_error(e)
+
+
+@mcp.tool(
+    name="nintendo_set_app_allow_list",
+    annotations={
+        "title": "Set Application Allow-List Status",
+        "readOnlyHint": False,
+        "destructiveHint": False,
+        "idempotentHint": True,
+        "openWorldHint": True,
+    },
+)
+async def nintendo_set_app_allow_list(params: SetAppAllowListInput, ctx: Context) -> str:
+    """Set whether an application can bypass content restrictions on a Nintendo Switch device.
+
+    Adding an application to the allow-list lets it be launched regardless of the
+    device's content restriction level (age rating filter). This is useful for
+    educational apps or games that are safe but might be blocked by strict settings.
+
+    Args:
+        params (SetAppAllowListInput): Validated input containing:
+            - device_id (str): The unique device ID (from nintendo_list_devices).
+            - application_id (str): The unique app ID (from nintendo_list_applications).
+            - allow (bool): True to add to allow-list, False to remove from allow-list.
+
+    Returns:
+        str: Confirmation message, or an error message.
+
+    Error Handling:
+        - Returns "Error: Not authenticated..." if no session token is configured.
+        - Returns "Error: ..." if the application_id is not found on the device.
+    """
+    err = require_client(_state.get("client"))
+    if err:
+        return err
+
+    try:
+        client = _state["client"]
+        device = client.devices.get(params.device_id)
+        if device is None:
+            return (
+                f"Error: Device '{params.device_id}' not found. "
+                "Use nintendo_list_devices to see available device IDs."
+            )
+
+        await device.update()
+        try:
+            app = device.get_application(params.application_id)
+        except ValueError:
+            return (
+                f"Error: Application '{params.application_id}' not found on device '{device.name}'. "
+                "Use nintendo_list_applications to see available application IDs."
+            )
+
+        setting = SafeLaunchSetting.ALLOW if params.allow else SafeLaunchSetting.NONE
+        await app.set_safe_launch_setting(setting)
+
+        if params.allow:
+            return (
+                f"✓ '{app.name}' added to the allow-list on '{device.name}'. "
+                "It can now bypass content restrictions."
+            )
+        return (
+            f"✓ '{app.name}' removed from the allow-list on '{device.name}'. "
+            "It is now subject to normal content restrictions."
+        )
+
+    except Exception as e:
+        return handle_error(e)