App Connections Manager

Inspect what app connections are available in your workspace via bridge apps.

Commands

List all connected apps

bridge apps list

Human-readable lines: <slug> [<status>] (<label>) — <capabilities>. Add --json for the full shape.

JSON shape:

{
  "apps": [
    {
      "id": "uuid",
      "slug": "pipedream:notion",
      "label": "Notion",
      "upstreamSlug": "notion",
      "status": "active",
      "origin": "pipedream",
      "authMethod": "broker_ref",
      "transport": "mcp",
      "capabilities": ["notes", "project_planning"]
    }
  ]
}

Get one app's metadata

bridge apps get notion

Returns the row above (no credentials).

Get decrypted credentials

bridge apps credentials notion

Returns the credential envelope:

{
  "ok": true,
  "slug": "pipedream:notion",
  "credentials": {
    "kind": "broker_ref",       // or "oauth" | "keys"
    "external_user_id": "...",  // shape depends on kind
    "account_id": "..."
  }
}

For OAuth apps the envelope holds access_token, refresh_token, etc. For keys apps it holds whatever fields the app stores (e.g. api_key). Use jq to extract:

TOKEN=$(bridge apps credentials notion | jq -r '.credentials.access_token')

Slug matching

Slug arguments accept either the exact stored slug (pipedream:notion, mcp:cline.bot, custom:linear-key) or the upstream slug (notion, cline, linear). When ambiguous, the exact slug wins.

Usage in Skills

# Check for a Notion connection
RESP=$(bridge apps credentials notion 2>/dev/null)

if [ $? -eq 0 ]; then
  echo "Notion connection exists"
  TOKEN=$(echo "$RESP" | jq -r '.credentials.access_token')
else
  echo "No Notion connection found"
  # Prompt user to connect via the Apps page
fi

Scope Behavior

bridge apps resolves automatically for the current claw. The tool port is loopback-only on the claw's own container — every reply is already scoped to this claw's grants via claw_app_access.

Use a personal claw when you need:

• Private Notion pages
• Personal calendar access
• Individual API keys

On a personal claw:

• bridge apps credentials notion returns whichever Notion app is granted to this claw (personal or team-shared).

On Team WorkClaw:

• Only team-scoped apps that have been granted to Team WorkClaw appear in bridge apps list. If you need a private app, install/connect it explicitly via the Apps page.

No --team or --user flags. The current claw is inferred from the runtime env.