# punchlist-mcp

Source: https://glimind.com/server/npm%2Fpunchlist-mcp
Registry id: `npm/punchlist-mcp`
Status: unknown

## Install

```json
{
  "mcpServers": {
    "punchlist-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "punchlist-mcp"
      ]
    }
  }
}
```

Claude Code:

```sh
claude mcp add punchlist-mcp -- npx -y punchlist-mcp
```

## Tools (15)

- `add_app`: Registers an app on the device's Apps tab (optionally with icon + instructions in one call).
- `connect_icloud`: Opens the Apple ID sign-in in your browser and adds your private CloudKit database as a second source (works off-LAN).
- `diagnose_processed_sync`: Debugging aid: traces why a processed mark isn't reaching the phone/cloud.
- `export_icloud_credentials`: Same sign-in flow, but mints a separate token to set as env vars in a remote environment.
- `fetch_punchlist`: Downloads + unzips into the cache, returns the manifest plus absolute local paths for every screenshot (and the video if include_video: true).
- `get_punchlist_manifest`: Just the manifest.json, no media download.
- `list_apps`: Apps registered on the device, with session/pending counts and standing instructions.
- `list_devices`: mDNS scan of _punchlist._tcp; returns devices + whether each is paired.
- `list_pending_punchlists`: Unprocessed sessions (GET /mcp/pending), optionally scoped to one app.
- `list_punchlists`: All sessions (GET /punchlists).
- `mark_punchlist_processed`: Marks a session consumed (POST /punchlists/{id}/processed) — requires the user's explicit yes.
- `pair_device`: Exchanges the app's 6-digit code for a token (and pins the device's TLS fingerprint).
- `set_app_instructions`: Standing processing instructions for an app; can sync from local .md files.
- `set_preferred_device`: Sets the default device used when device is omitted.
- `upload_app_icon`: Pushes the app's icon PNG so the device's picker shows the real icon.

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.
