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

# toolshed connect

> Link an OAuth provider to your Toolshed account.

## Usage

```bash theme={null}
toolshed connect <provider>
```

| Argument   | Required | Description                                   |
| ---------- | -------- | --------------------------------------------- |
| `provider` | Yes      | One of: `github`, `google`, `slack`, `linear` |

## Prerequisites

You must be logged in first. Run [`toolshed login`](/cli/login) if you haven't already.

## How it works

1. The CLI reads your config from `~/.toolshed/config.json` to get your user ID and server URL
2. Starts a temporary local HTTP server on a random port
3. Opens your browser to the server's OAuth login endpoint for the chosen provider
4. The server runs the standard OAuth2 flow (with PKCE where supported)
5. After you authorize in the provider's UI, the server stores encrypted tokens and redirects back to the CLI
6. The CLI confirms the connection and exits

## Example

```bash theme={null}
$ toolshed connect github
Connecting github...
Opening browser to authorize github...
Connected github successfully!
```

## Checking connections

Use [`toolshed status`](/cli/status) to see which providers are connected:

```bash theme={null}
$ toolshed status
Server:  http://localhost:3001
User:    user_f7c469e8
Providers: github, google
```

## Provider details

| Provider | PKCE       | Scopes                                       |
| -------- | ---------- | -------------------------------------------- |
| GitHub   | No         | `repo`, `read:user`                          |
| Google   | Yes (S256) | `gmail.modify`, `calendar`, `drive.readonly` |
| Slack    | No         | `channels:read`, `chat:write`, `groups:read` |
| Linear   | Yes (S256) | `read`, `write`                              |

See [OAuth Setup](/guides/oauth-setup) for server-side configuration requirements.