
# Connectors

**Connectors** bring your external services into SweetHive so their content can be
shared into contexts with the same group-based visibility as everything else. Open
the hub from **My SweetHive → Connectors** or the **Connectors** item in the icon
rail.

## Available today

- **Gmail** — browse your inbox (read-only) and share an email into a context as a
  rich card.
- **Google Calendar** — browse your upcoming events (read-only) and share an event
  into a context.
- **Google Drive** — browse your files (read-only) and share a file card into a
  context. Drive shares the same Google connection as Gmail and Calendar.

More connectors — Outlook, Dropbox, OneDrive, Slack, Telegram, Trello, Asana, Jira,
GitHub — are on the roadmap and appear in the hub as **coming soon**.

## Connect Google

1. Open **Connectors → Gmail** (or Google Drive).
2. Choose **Connect** — a Google consent window opens; approve the read-only scopes.
3. Your mail / events / files appear in the connector page, read-only.

**Privacy by design:**

- Access is **read-only** — SweetHive never sends mail, creates events or modifies
  files on your behalf.
- Your Google tokens are stored **server-side only** and never reach the browser.
- Disconnect at any time from the connector page; access stops immediately.
- If a new capability is added to the Google connector (as Drive was), you'll simply
  be asked to reconnect once to grant the extra read scope.

## Share into a context

Every mail, event or file in a connector has a **Share** action:

1. Choose **Share** on the item.
2. Pick the **hive → context → groups** in the share dialog.
3. Send — the item lands in the context feed as a rich card (subject/sender for
   mail, title/time for events, name/type for files), visible only to the groups you
   targeted.

This is the bridge between your personal tools and your team's contexts: instead of
forwarding an email, you *place* it where it belongs.
