Connect Your First Integration

Integrations are external services that Skillett can interact with on your behalf. Each integration uses OAuth 2.0 — you authorize once, and Skillett manages token storage and refresh.

Available integrations

Integration	Slug	Endpoints	Description
GitHub	`github`	55+	Issues, PRs, repos, actions, search
Gmail	`gmail`	12+	Send, read, search, label emails
Google Calendar	`google-calendar`	10+	Events, calendars, scheduling
Google Drive	`google-drive`	15+	Files, folders, permissions, search
Google Sheets	`google-sheets`	10+	Read, write, create spreadsheets
Notion	`notion`	12+	Pages, databases, blocks, search

Connecting

Run the connect command
Terminal window
```
skillett connect github
```
The CLI calls POST /v1/connect and receives an OAuth URL.
Authorize in browser

Your browser opens to the service’s OAuth consent screen. Review the requested scopes and click Authorize.
Return to terminal

The CLI polls for completion. Once the OAuth callback is processed:
```
{ "status": "connected", "integration": "github" }
```

Plan limits

Your plan determines how many integrations you can connect simultaneously:

Plan	Max connections
Free	3
Pro ($29/mo)	10
Unlimited ($49/mo)	Unlimited

Disconnecting

skillett disconnect github

{ "status": "disconnected", "integration": "github" }

This revokes the stored OAuth tokens. You can reconnect at any time by running skillett connect again.

Connection states

State	Meaning
`connected`	Active, tokens valid
`pending`	OAuth flow in progress
`error`	Token refresh failed — reconnect needed
`not_connected`	Never connected or disconnected

If a connection enters error state (e.g., you revoked access on the provider’s side), run skillett connect <integration> to re-authorize.