# List Personal Connectors

div
strong
🔨 In Development
 — This section is still being developed and may change.


Returns a list of available personal connectors that can be configured for use with AI assistants.

Retrieves all available personal connector definitions, including official (externally hosted), Aitronos-built (hosted by Aitronos), and custom connectors.

#### Query Parameters

**`type`** string optional

Filter by connector type. Values: `official`, `aitronos_built`, `custom`.

**`category`** string optional

Filter by category. Values: `productivity`, `development`, `communication`, `design`, `custom`.

**`status`** string optional

Filter by status. Values: `active`, `deprecated`, `maintenance`. Defaults to `active`.

**`limit`** integer optional

Maximum number of connectors to return. Defaults to `20`. Maximum: `100`.

**`offset`** integer optional

Number of connectors to skip for pagination. Defaults to `0`.

All Connectors

```bash
curl https://api.freddy.aitronos.com/v1/personal-connectors \
  -H "Authorization: Bearer $FREDDY_API_KEY"
```


```python
import requests

response = requests.get(
    "https://api.freddy.aitronos.com/v1/personal-connectors",
    headers={"Authorization": f"Bearer {api_key}"}
)

connectors = response.json()
print(f"Found {len(connectors['data'])} connectors")
```


```javascript
const response = await fetch('https://api.freddy.aitronos.com/v1/personal-connectors', {
  headers: {
    'Authorization': `Bearer ${apiKey}`
  }
});

const connectors = await response.json();
console.log(`Found ${connectors.data.length} connectors`);
```

Filter by Type

```bash
curl "https://api.freddy.aitronos.com/v1/personal-connectors?type=aitronos_built" \
  -H "Authorization: Bearer $FREDDY_API_KEY"
```


```python
import requests

response = requests.get(
    "https://api.freddy.aitronos.com/v1/personal-connectors",
    headers={"Authorization": f"Bearer {api_key}"},
    params={"type": "aitronos_built"}
)

connectors = response.json()
```


```javascript
const response = await fetch('https://api.freddy.aitronos.com/v1/personal-connectors?type=aitronos_built', {
  headers: {
    'Authorization': `Bearer ${apiKey}`
  }
});
```

Filter by Category

```bash
curl "https://api.freddy.aitronos.com/v1/personal-connectors?category=productivity" \
  -H "Authorization: Bearer $FREDDY_API_KEY"
```


```python
import requests

response = requests.get(
    "https://api.freddy.aitronos.com/v1/personal-connectors",
    headers={"Authorization": f"Bearer {api_key}"},
    params={"category": "productivity"}
)
```


```javascript
const response = await fetch('https://api.freddy.aitronos.com/v1/personal-connectors?category=productivity', {
  headers: {
    'Authorization': `Bearer ${apiKey}`
  }
});
```

## Response

200 OK

```json
{
  "object": "list",
  "data": [
    {
      "id": "pcon_github",
      "object": "personal_connector",
      "name": "GitHub",
      "type": "official",
      "connectorId": "github",
      "description": "Official GitHub MCP Server",
      "iconUrl": "https://github.githubassets.com/images/modules/logos_page/GitHub-Mark.png",
      "category": "development",
      "version": "1.0.0",
      "status": "active",
      "serverUrl": "https://github-mcp.example.com",
      "serverType": "http",
      "createdAt": "2025-01-01T00:00:00Z",
      "updatedAt": "2025-01-01T00:00:00Z"
    },
    {
      "id": "pcon_clickup",
      "object": "personal_connector",
      "name": "ClickUp",
      "type": "aitronos_built",
      "connectorId": "clickup",
      "description": "ClickUp task management integration",
      "iconUrl": "https://clickup.com/landing/images/logo-clickup_color.svg",
      "category": "productivity",
      "version": "1.0.0",
      "status": "active",
      "serverUrl": "http://clickup-mcp:8000",
      "serverType": "http",
      "createdAt": "2025-01-01T00:00:00Z",
      "updatedAt": "2025-01-01T00:00:00Z"
    }
  ],
  "hasMore": false,
  "total": 2
}
```

Errors

```json
{
  "error": {
    "type": "authentication_error",
    "message": "Invalid API key",
    "code": "invalid_api_key"
  }
}
```


```json
{
  "error": {
    "type": "invalid_request_error",
    "message": "Invalid type filter value",
    "code": "invalid_parameter",
    "param": "type"
  }
}
```