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

# apps_list

> What the person's connected apps can do.

> [!NOTE]
>
> Free · Your key and project keys

Lists actions for the apps connected to Constella (Gmail, Google Calendar, Notion, Slack, Google Drive and more). Run one with [apps\_run](/dev/docs/api-reference/tools/apps-run.md).

Call it at `POST /platform/v1/me/tools/apps_list` or, for one of your app's users, `POST /platform/v1/users/{uid}/tools/apps_list`. On MCP, your AI tool calls `apps_list` with the same arguments.

## Arguments

Send these inside `arguments`.

**user\_timezone** `string` (default: "UTC")

The person's time zone, like `"America/Los_Angeles"`, so dates are right.

## Returns

The tool's answer comes back under `result`.

**connected\_apps** `string[]`

The apps that are connected.

**actions** `object[]`

Each has `name`, `description` and `input_schema`.

```bash Your key theme={"system"}
curl https://api.constella.app/platform/v1/me/tools/apps_list \
  -H "Authorization: Bearer $CONSTELLA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"arguments": {"user_timezone": "America/Los_Angeles"}}'
```

```bash Project key theme={"system"}
curl https://api.constella.app/platform/v1/users/u_123/tools/apps_list \
  -H "Authorization: Bearer $CONSTELLA_APP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"arguments": {"user_timezone": "America/Los_Angeles"}}'
```

```python Python theme={"system"}
import os, requests

r = requests.post(
    "https://api.constella.app/platform/v1/me/tools/apps_list",
    headers={"Authorization": f"Bearer {os.environ['CONSTELLA_API_KEY']}", "X-Constella-Client": "my-script"},
    json={"arguments": {"user_timezone": "America/Los_Angeles"}},
)
print(r.json()["result"])
```

```javascript JavaScript theme={"system"}
const res = await fetch("https://api.constella.app/platform/v1/me/tools/apps_list", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.CONSTELLA_API_KEY}`,
    "X-Constella-Client": "my-script",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({"arguments": {"user_timezone": "America/Los_Angeles"}}),
});
const { result } = await res.json();
```

```json 200 theme={"system"}
{
  "result": {
    "connected_apps": [
      "gmail",
      "notion"
    ],
    "actions": [
      {
        "name": "gmail_search",
        "description": "Search the person's email.",
        "input_schema": {
          "type": "object"
        }
      }
    ]
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.