# `connection` operations

> Source: https://clickhouse.github.io/loom/reference/operations/connection/ (Markdown: https://clickhouse.github.io/loom/reference/operations/connection.md)

The exact fields each `connection.*` operation takes and returns.

<!-- Generated by `python scripts/codegen/docs_reference.py` from the op registry; edit the models, not this page. -->

Every op is `POST /v1/<op>` over HTTP and the MCP tool `loom_<op>`. The identity fields (`org`, `namespace`, `agent`, `user_id`, `session_id`) are filled from the token and the MCP session when a transport can; for an HTTP call with no token on a single-user server, the install's org on every op but `code.*` and `tracker.*` (which keep their plane's), and on [some ops](https://clickhouse.github.io/loom/reference/http-api.md#request) its namespace and agent; see [identities and namespaces](https://clickhouse.github.io/loom/concepts/identities-and-namespaces.md). The [operations index](https://clickhouse.github.io/loom/reference/operations.md) explains role, kind and the MCP `all` listing. Unknown input fields are served and named in `ignored_args`.

<!-- prettier-ignore-start -->

## `connection.disconnect`

Disconnect the caller's own provider account and stop its connected sources.

`POST /v1/connection.disconnect` · MCP `loom_connection_disconnect` · role `viewer` · idempotent · not listed under the MCP `all` toolset

| Input field | Type | Default | Meaning |
| --- | --- | --- | --- |
| `org` | `str` | required | The caller's organization. |
| `kind` | `Literal['gdrive', 'notion', 'linear']` | required | The connected provider to disconnect. |

| Output field | Type | Meaning |
| --- | --- | --- |
| `disconnected` | `bool` |  |

## `connection.list`

List the signed-in caller's own connected provider accounts.

`POST /v1/connection.list` · MCP `loom_connection_list` · role `viewer` · read · not listed under the MCP `all` toolset

| Input field | Type | Default | Meaning |
| --- | --- | --- | --- |
| `org` | `str` | required | The caller's organization. |

| Output field | Type | Meaning |
| --- | --- | --- |
| `connections` | `list[ConnectionEntry]` |  |

<!-- prettier-ignore-end -->
