> ## Documentation Index
> Fetch the complete documentation index at: https://docs.argentos.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connectors Overview

> AOS connectors give your agent structured access to external services — no MCP servers, no daemons, just CLI tools with JSON output.

## What Are Connectors?

AOS connectors are **CLI tools** that give your ArgentOS agent structured, permission-controlled access to external services. Every connector follows the `aos-*` naming convention and implements a standard contract: JSON output, permission tiers, self-describing capabilities, and built-in health checks.

Unlike MCP servers or plugin extensions, connectors require no long-running processes. They are invoked as shell commands, return JSON, and exit. Any agent that can run shell commands can use them.

```bash theme={null}
# List GitHub issues
aos-github --json --mode readonly issue.list

# Send a Twilio SMS
aos-twilio --json --mode write messages.send --to "+1555..." --body "Hello"

# Check QuickBooks health
aos-quickbooks --json health
```

## Architecture

```mermaid theme={null}
flowchart TD
    A["Agent requests action"] --> B["ArgentOS tool router"]
    B --> C["aos-* CLI tool"]
    C --> D["Permission gate (--mode)"]
    D --> E["Backend adapter (API/SDK)"]
    E --> F["JSON response envelope"]
    F --> G["Agent processes result"]
```

Key design decisions:

* **No daemons** — connectors are stateless CLI calls
* **JSON-first** — every command returns a structured envelope
* **Permission-enforced** — `readonly`, `write`, `full`, `admin` tiers
* **Self-describing** — `capabilities --json` returns the full command manifest
* **Health-checked** — `health --json` reports readiness and setup status

## Available Connectors

ArgentOS ships with **61 connectors** covering CRM, project management, communication, accounting, developer tools, and more:

<CardGroup cols={3}>
  <Card title="CRM & Sales" icon="handshake">
    aos-hubspot, aos-salesforce, aos-pipedrive, aos-close, aos-clientsync
  </Card>

  <Card title="Project Management" icon="list-check">
    aos-linear, aos-jira, aos-asana, aos-clickup, aos-monday, aos-trello, aos-notion, aos-dart
  </Card>

  <Card title="Communication" icon="message">
    aos-slack, aos-teams, aos-twilio, aos-discord-workflow, aos-slack-workflow
  </Card>

  <Card title="Accounting & Finance" icon="calculator">
    aos-quickbooks, aos-xero, aos-stripe, aos-square, aos-paypunch
  </Card>

  <Card title="Marketing" icon="bullhorn">
    aos-mailchimp, aos-klaviyo, aos-buffer, aos-hootsuite
  </Card>

  <Card title="Developer Tools" icon="code">
    aos-github, aos-coderabbit, aos-blacksmith, aos-neon, aos-supabase, aos-pinecone
  </Card>

  <Card title="E-Commerce" icon="cart-shopping">
    aos-shopify, aos-woocommerce, aos-wordpress
  </Card>

  <Card title="Productivity" icon="briefcase">
    aos-google, aos-google-drive, aos-google-places, aos-m365, aos-airtable, aos-box, aos-dropbox, aos-calendly
  </Card>

  <Card title="AI & Media" icon="wand-magic-sparkles">
    aos-openai, aos-anthropic, aos-claude-code, aos-elevenlabs, aos-canva, aos-nanob, aos-perplexity, aos-firecrawl
  </Card>

  <Card title="Automation" icon="robot">
    aos-zapier, aos-make, aos-n8n
  </Card>

  <Card title="MSP & IT" icon="server">
    aos-connectwise, aos-holace, aos-lion-report, aos-callscrub
  </Card>

  <Card title="Email" icon="envelope">
    aos-sendgrid, aos-resend, aos-pagerduty
  </Card>
</CardGroup>

## Where Connectors Live

Connectors are discovered from multiple locations (checked in order):

| Location                          | Purpose                                   |
| --------------------------------- | ----------------------------------------- |
| `tools/aos/` in the ArgentOS repo | Vendored connectors shipped with ArgentOS |
| `~/.argentos/connectors/`         | User-installed connectors                 |
| `ARGENT_CONNECTOR_REPOS` env var  | Custom connector directories              |
| System `PATH`                     | Any `aos-*` binary on PATH                |

## Three Types of Packages in ArgentOS

| Type           | Format                | What It Does                           | Examples                          |
| -------------- | --------------------- | -------------------------------------- | --------------------------------- |
| **Connectors** | Python CLI (`aos-*`)  | Structured access to external services | aos-github, aos-slack, aos-stripe |
| **Skills**     | Markdown (`SKILL.md`) | Agent capabilities and knowledge       | weather, github, spotify-player   |
| **Extensions** | TypeScript plugin     | Gateway hooks, channels, tools         | telegram, discord, aos-lcm        |

## Deep Dives

<CardGroup cols={2}>
  <Card title="How Connectors Work" icon="gears" href="/connectors/how-it-works">
    CLI contract, JSON envelopes, permission model, health checks
  </Card>

  <Card title="Build a Connector" icon="hammer" href="/connectors/build">
    Step-by-step guide to creating a new AOS connector from scratch
  </Card>

  <Card title="Publish to Marketplace" icon="store" href="/connectors/publish">
    Package, sign, submit, and list your connector
  </Card>

  <Card title="Connector Reference" icon="book" href="/connectors/reference">
    Full list of all 61 connectors with categories and commands
  </Card>
</CardGroup>