OXYGENOxygen/ Docs
Surfaces

Claude Cowork

Connect Claude Cowork to Oxygen and choose the tool scope scheduled tasks can actually dispatch.

Claude Cowork uses Oxygen through a hosted custom connector. Scheduled tasks reuse the connectors available to Cowork, so the connector URL determines which Oxygen tools the task can call.

Choose the connector scope

URLAdvertised scopeUse when
https://oxygen-agent.com/mcpCoreThe bounded golden-path toolset is enough. A bare URL means core.
https://oxygen-agent.com/mcp?toolset=coreCoreSame scope, made explicit.
https://oxygen-agent.com/mcp?toolset=crmCore + CRMThe task needs CRM record or relationship tools.
https://oxygen-agent.com/mcp?toolset=fullEvery customer toolExisting automations span several domains or require the former full scope.

Core stays the default because advertising several hundred schemas at once consumes substantial context and makes tool selection less reliable. Domain packs are additive on core; available packs include crm, tables, enrichment, signals, sequences, deliverability, inbox, publishing, workflows, agents, billing, and integrations.

Restore the full scope

  1. Open Claude Settings → Connectors.
  2. Remove the existing Oxygen custom connector. Changing or removing ?toolset=core is not enough: a bare Oxygen URL still selects core.
  3. Add a custom connector with this exact URL:
https://oxygen-agent.com/mcp?toolset=full
  1. Complete the Oxygen OAuth sign-in again.
  2. In Cowork, ask Oxygen to run the read-only oxygen_whoami tool and confirm the expected organization.
  3. Re-run the scheduled task. No Oxygen data or schedule definition needs to be recreated.

For a CRM-only task, use https://oxygen-agent.com/mcp?toolset=crm instead. That pack advertises oxygen_crm_record_assert and oxygen_crm_relationship_upsert without loading unrelated domains.

Why capability search alone may not unblock Cowork

oxygen_capabilities_search and oxygen_capabilities_schema can discover every Oxygen tool. Their results include toolset_pack, the smallest connector profile that advertises the selected tool.

The Oxygen server can dispatch an exact hidden tool name, but Cowork rejects a name that was not included in its connector's tools/list before the call reaches Oxygen. If Cowork reports No such tool available, reconnect with the returned ?toolset=<toolset_pack> or use explicit ?toolset=full for a genuinely cross-domain automation.

Cost and approval posture

Changing the advertised tool scope does not authorize spending or external writes. Paid calls and external mutations still require their normal preview, exact scope, approval, and credit ceiling.

On this page