cargo-connection
Connect Cargo to an external system and find out what it can do — authenticate connectors, browse the integration catalog, and resolve the `connectorUuid` and `actionSlug` a workflow node needs. Triggers: "connect my HubSpot", "is Salesforce connected", "what integrations do you support", "can Cargo talk to <tool>", "what actions does <provider> have", "I need the connector UUID", "set up the API key for", "it is asking for credentials again", "why is this connector failing auth", "list my connectors". Integrations: amplemarket, amplitude, attio, bigQuery, calendly, closecom, contrast, csv, customerio, dbt, emailBison, expandi, googleAds, googleSheets, heyReach, http, hubspot, hubspotMcp, instantly, instantlyV2, intercom, jira, kitt, lemlist, lgm, linkedinAds, linkedinMatchedAudience, livestorm, manus, marketo, metabase, microsoftTeams, mixpanel, netsuite, netsuiteSoap, notionMcp, octave, onesignal, outreach, pipedrive, postgresql, redshift, resend, rift, salesforce, salesforceMcp, salesloft, Sendgrid, sillage, slack, smartlead, snowflake, sql, stripe, and 82 more. Skip when: choosing between enrichment providers for a GTM job — use cargo-gtm and its provider playbooks.
Rank
62
Safety
84
Downloads
1.5k
Updated
Oct 10, 2026
Version
1.5.0
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.5K downloads reported by the source. Last updated 10/10/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 10, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 10, 2026
- Adoption signal
- 1.5K downloadsadoption · observed Oct 10, 2026
- Latest release
- 1.5.0release · observed Sep 16, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s178dcd9wkfn0a2fqrygmt3jzn87j9e1:cargo-connection- Install using `clawhub skill install s178dcd9wkfn0a2fqrygmt3jzn87j9e1:cargo-connection` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/cargo-ai/cargo-connection before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-cargo-ai-cargo-connection/snapshot"
Documentation
CLAWHUB
148,184 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: cargo-connection
description: "Connect Cargo to an external system and find out what it can do — authenticate connectors, browse the integration catalog, and resolve the `connectorUuid` and `actionSlug` a workflow node needs. Triggers: \"connect my HubSpot\", \"is Salesforce connected\", \"what integrations do you support\", \"can Cargo talk to <tool>\", \"what actions does <provider> have\", \"I need the connector UUID\", \"set up the API key for\", \"it is asking for credentials again\", \"why is this connector failing auth\", \"list my connectors\". Integrations: amplemarket, amplitude, attio, bigQuery, calendly, closecom, contrast, csv, customerio, dbt, emailBison, expandi, googleAds, googleSheets, heyReach, http, hubspot, hubspotMcp, instantly, instantlyV2, intercom, jira, kitt, lemlist, lgm, linkedinAds, linkedinMatchedAudience, livestorm, manus, marketo, metabase, microsoftTeams, mixpanel, netsuite, netsuiteSoap, notionMcp, octave, onesignal, outreach, pipedrive, postgresql, redshift, resend, rift, salesforce, salesforceMcp, salesloft, Sendgrid, sillage, slack, smartlead, snowflake, sql, stripe, and 82 more. Skip when: choosing between enrichment providers for a GTM job — use cargo-gtm and its provider playbooks."
version: "1.5.0"
compatibility: Requires @cargo-ai/cli (npm). Sign in or create an account with `cargo-ai login --email` (emailed code, no browser), `--oauth`, or an API token
homepage: https://github.com/getcargohq/cargo-skills
metadata:
author: getcargo
openclaw:
requires:
bins:
- cargo-ai
install:
- kind: node
package: "@cargo-ai/cli@latest"
bins:
- cargo-ai
homepage: https://github.com/getcargohq/cargo-skills
---
# Cargo CLI — Connections
Connector and integration management: listing connectors, discovering available integrations, and managing authenticated connector instances.
> See `references/response-shapes.md` for full JSON response structures.
> See `references/troubleshooting.md` for common errors and how to fix them.
> See `references/examples/connectors.md` for connector CRUD and discovery examples.
> See `references/examples/integrations.md` for listing available integrations and OAuth flows.
> For third-party connector rate limit handling and retry config in workflows, see `cargo-orchestration/references/polling.md` and `cargo-orchestration/references/troubleshooting.md`. Native integrations do not have rate limits.
## Bootstrap
Already signed in (`cargo-ai whoami` returns a workspace)? Skip to the next section.
```bash
npm install -g @cargo-ai/cli # no global install? prefix every command with `npx @cargo-ai/cli`
cargo-ai login --email [email protected] # emailed code, no browser; creates the account on first use
# alternatives: --oauth (browser) · --token <api-token> (CI)
cargo-ai whoami # confirm the active workspace before any write
```
Every command prints JSO_meta.json
{
"ownerId": "kn7by8t6yt9yghbxtxz6hv0bts87k6bq",
"slug": "cargo-connection",
"version": "1.5.0",
"publishedAt": 1789543565115
}references/examples/connectors.md
# Connector examples
## List all connectors
```bash
cargo-ai connection connector list
```
## Filter connectors by integration
```bash
cargo-ai connection connector list --integration-slug clearbit
# → Returns only connectors for the Clearbit integration
```
## Get a single connector
```bash
cargo-ai connection connector get <connector-uuid>
# → Returns the full connector object (same shape as an item from connector list)
```
## Find a connector UUID for use in a workflow
```bash
# 1. List connectors (optionally filter by integration)
cargo-ai connection connector list --integration-slug clearbit
# → Extract the "uuid" field from the right connector
# 2. Use the UUID in your workflow node's connectorUuid config
```
## Create a connector
```bash
cargo-ai connection connector create \
--integration-slug clearbit \
--slug clearbit_production \
--name "Clearbit - Production"
```
`--slug` is a unique identifier (no spaces), `--name` is the display name. For credit-based integrations (`useCredits: true`), this is all that's needed. For credential-based integrations, pass `--config` with the integration-specific credentials JSON.
## Update a connector
```bash
cargo-ai connection connector update --uuid <connector-uuid> --name "Clearbit - Staging"
cargo-ai connection connector update --uuid <connector-uuid> --config '{"apiKey":"new-key"}'
```
## Remove a connector
```bash
# Check usage first — list connectors and check playsCount and toolsCount
cargo-ai connection connector list
# → High counts mean the connector is heavily used — remove dependencies before deleting
cargo-ai connection connector remove <connector-uuid>
```
## Check if a slug is available
```bash
cargo-ai connection connector exists-by-slug --slug clearbit_production
# → { "exists": true }
```
## Connector usage audit
Find all connectors and how many plays/tools use each:
```bash
cargo-ai connection connector list
# → Check playsCount and toolsCount fields for each connector
```
## Autocomplete — fetch available values for an action field
When an action's `uiSchema` marks a field with `"ui:widget": "IntegrationAutocompleteWidget"`, use `connector autocomplete` to get the allowed values.
```bash
# Basic autocomplete (no params needed)
cargo-ai connection connector autocomplete \
--connector-uuid <connector-uuid> \
--slug listObjects \
--params '{}'
# → { "results": [{ "label": "Contacts", "value": "contacts" }, ...] }
```
## Autocomplete with dependent parameters
Some fields depend on another field's value. Pass the dependency in `--params`:
```bash
# Get properties for a specific object type
cargo-ai connection connector autocomplete \
--connector-uuid <connector-uuid> \
--slug listObjectProperties \
--params '{"objectType": "contacts"}'
# → { "results": [{ "label": "Email", "value": "email" }, ...] }
```
## Autocomplete with search filtering
Use `--value` to filter results by a search string:
```bash
cargo-ai connection connector autocomplreferences/examples/integrations.md
# Integration examples ## List all available integrations ```bash cargo-ai connection integration list ``` Response includes `slug`, `name`, `description`, and `category` for each available integration. ## Filter integrations ```bash # By category cargo-ai connection integration list --category enrichment # By name search cargo-ai connection integration list --search "hubspot" # By exact slug(s) cargo-ai connection integration list --slugs clearbit # Only those with actions (usable in workflow nodes) cargo-ai connection integration list --has-actions true # Only those with extractors (can sync data into models) cargo-ai connection integration list --has-extractors true ``` **Categories:** `engagement`, `marketing`, `sales`, `finance`, `analytics`, `freeform`, `success`, `support`, `enrichment`, `storage`, `custom`. ## Find an integration slug ```bash cargo-ai connection integration list --search "hubspot" # → Extract the "slug" value # → Use slug when creating connectors: --integration-slug <slug> ``` ## Get full integration details ```bash cargo-ai connection integration get clearbit # → Returns the full integration object with actions, extractors, and configuration schemas ``` Use this to discover all available actions and extractors for an integration, including their `config.jsonSchema` for building workflow nodes. ## Get integration documentation ```bash cargo-ai connection integration get-documentation clearbit cargo-ai connection integration get-documentation hubspot ``` Returns plain text documentation for the integration, including available actions and their configuration. ## Discover actions for a specific integration (e.g. HubSpot) ```bash cargo-ai connection integration get hubspot # → Returns HubSpot-specific actions (e.g. "create_contact", "update_deal") and extractors # → Each action includes its config.jsonSchema for building workflow nodes cargo-ai connection integration get-documentation hubspot # → Plain text overview of all HubSpot actions ``` **Use `integration get <slug>` when you need service-specific actions** — HubSpot, Salesforce, Clearbit, etc. ## Discover native (built-in Cargo) actions and extractors ```bash cargo-ai connection native-integration get # → Returns built-in Cargo actions ONLY — NOT HubSpot or other third-party actions # → actions: keyed by actionSlug (generic platform utilities) # → extractors: keyed by extractor slug ``` **Important:** `native-integration get` does **not** return HubSpot-specific or other third-party connector actions. To get those, use `integration get <slug>` instead. Use `actionSlug` values in workflow node configs (see `cargo-orchestration/references/nodes.md`). ## Set up a connector for use in workflows (full flow) ```bash # 1. Find the integration slug cargo-ai connection integration list --search "hubspot" # → Extract the "slug" value # 2. Create the connector cargo-ai connection connector create \ --integration-slug hubspot \ --slug hubspot_prod
references/response-shapes.md
# Response shapes
JSON response structures returned by Cargo CLI commands used in the `cargo-connection` skill.
## cargo-ai connection connector list
```json
{
"connectors": [
{
"uuid": "connector-uuid",
"workspaceUuid": "...",
"userUuid": "...",
"name": "Clearbit - Production",
"slug": "clearbit_production",
"integrationSlug": "clearbit",
"rateLimit": { "unit": "day", "max": 1000 },
"cacheTtlMilliseconds": 86400000,
"playsCount": 2,
"toolsCount": 5,
"modelsCount": 0,
"useCredits": true,
"config": null,
"createdAt": "2025-01-01T00:00:00Z",
"updatedAt": "2025-01-15T00:00:00Z",
"deletedAt": null
}
]
}
```
**Key fields:** `uuid`, `name`, `integrationSlug`, `useCredits`, `playsCount`, `toolsCount`.
When `useCredits` is `true`, actions on this connector consume Cargo credits. When `false`, `config` contains the integration-specific credentials.
## cargo-ai connection connector get
```json
{
"connector": {
"uuid": "connector-uuid",
"workspaceUuid": "...",
"userUuid": "...",
"name": "Clearbit - Production",
"slug": "clearbit_production",
"integrationSlug": "clearbit",
"rateLimit": { "unit": "day", "max": 1000 },
"cacheTtlMilliseconds": 86400000,
"playsCount": 2,
"toolsCount": 5,
"modelsCount": 0,
"useCredits": true,
"config": null,
"createdAt": "2025-01-01T00:00:00Z",
"updatedAt": "2025-01-15T00:00:00Z",
"deletedAt": null
}
}
```
Same shape as a single item from `connector list`.
## cargo-ai connection integration list
Each integration in the list is a full integration object (same shape as `integration get`).
```json
{
"integrations": [
{
"slug": "clearbit",
"name": "Clearbit",
"description": "Company and person enrichment",
"category": "enrichment",
"icon": "https://...",
"color": "#...",
"url": "https://...",
"subCategories": [],
"documentationPath": "...",
"connector": { "config": { "jsonSchema": { ... } } },
"actions": { "enrichCompanyFromDomain": { ... } },
"extractors": {},
"dynamicSchemas": {}
}
]
}
```
**Key fields:** `slug` (used when creating connectors and filtering), `name`, `category`, `actions`, `extractors`.
Supports `--category`, `--slugs`, `--search`, `--has-actions`, `--has-extractors` to filter results.
**Integration categories:** `engagement`, `marketing`, `sales`, `finance`, `analytics`, `freeform`, `success`, `support`, `enrichment`, `storage`, `custom`.
## cargo-ai connection integration get
Returns the full integration object, including all actions and extractors with their configuration schemas.
```json
{
"integration": {
"slug": "clearbit",
"name": "Clearbit",
"description": "Company and person enrichment",
"category": "enrichment",
"icon": "https://...",
"color": "#...",
"url": "https://...",
"subCategories": [],
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/cargo-ai/skills/cargo-connection",
"sourceUrl": "https://clawhub.ai/cargo-ai/skills/cargo-connection",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T09:52:45.977Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-cargo-ai-cargo-connection/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-cargo-ai-cargo-connection/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T09:52:45.977Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.5K downloads",
"href": "https://clawhub.ai/cargo-ai/cargo-connection",
"sourceUrl": "https://clawhub.ai/cargo-ai/cargo-connection",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T09:52:45.977Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.5.0",
"href": "https://clawhub.ai/cargo-ai/cargo-connection",
"sourceUrl": "https://clawhub.ai/cargo-ai/cargo-connection",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-16T07:26:05.115Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-cargo-ai-cargo-connection/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-cargo-ai-cargo-connection/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.5.0",
"description": "- Version bump to 1.5.0. - Documentation updated: integration catalog now explicitly calls out deprecated integrations (`isDeprecated` flag and naming convention), guiding users not to use deprecated integrations for new workflows. - Removed deprecated documentation file: skill-card.md.",
"href": "https://clawhub.ai/cargo-ai/cargo-connection",
"sourceUrl": "https://clawhub.ai/cargo-ai/cargo-connection",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-16T07:26:05.115Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
