Connectors
Connectors
Connectors give your agents access to external services. Where integrations are messaging apps people reach an agent through, connectors are services an agent uses to get work done — reading email, looking up tickets, querying analytics, and so on. Most are backed by Composio, so the catalog covers a wide range of providers; Email (IMAP/SMTP) is built in and works with almost any mailbox. Any remote MCP server can be added here too.
Open Connectors from the left rail — it's a top-level item, alongside Scheduled tasks.
The catalog
The Connectors page opens on Browse connectors — a catalog grouped by category, with a search box. Already-set-up services appear under a Connected heading at the top; everything else is under Available. Only connector accounts appear here — credentials used by your own custom skills live in Secrets. A separate All skills view lists installable skills.
Connect an account
- Open Connectors and find the service you want.
- Select it to open the connect account modal. The modal adapts to how the service
authenticates:
- OAuth — you're redirected to the provider to authorize, then brought back. No keys to copy.
- API key — paste the key.
- Username & password — enter the login pair.
- Generic — paste a single value.
- Give the account a label (useful when you connect several accounts of the same service), then connect.
After connecting, the account is automatically assigned to all your agents so it's usable right away. For OAuth accounts, the connected account's email is filled in for you.
Multiple accounts
You can connect more than one account of the same service — for example, several Gmail inboxes — and assign each one to different agents. On the Free and Starter plans, each connector holds one account and a workspace can use up to three connectors; see Plans & billing.
Email (IMAP/SMTP)
Email (IMAP/SMTP) connects any mailbox that supports IMAP and SMTP — Gmail, Yahoo, iCloud, Fastmail, Zoho, or your own mail server. Your agents can list folders, search and read mail, send and reply (with attachments from their workspace), mark messages read or flagged, move them, delete them, and save small attachments to their workspace.
- In Browse connectors, choose Email (IMAP/SMTP).
- Enter your email address. For a known provider the server settings fill in automatically; otherwise pick Other and enter the IMAP and SMTP server, port and security.
- Enter the password. Most providers need an app password rather than your normal password — the form links to where you create one.
- Select Connect. We sign in to both servers before saving, so a wrong password or server shows up right away.
Your password is stored encrypted in the vault and is only used by BetterClaw to talk to your mail server — agents never see it.
Server settings
Open Server settings in the form to see or change how we connect. Presets are filled in for Gmail / Google Workspace, Yahoo Mail, iCloud Mail, Fastmail, and Zoho Mail; for anything else, use the values from your provider's IMAP/SMTP help page.
| Setting | What to enter |
|---|---|
| IMAP server / Port / Security | Where mail is read from — usually port 993 with SSL/TLS. |
| SMTP server / Port / Security | Where mail is sent through — usually port 465 with SSL/TLS, or 587 with STARTTLS (iCloud uses 587). |
| Username | Defaults to the email address. Change it only if your provider signs in with a different username. |
| Sender name | Optional, and shown above Server settings. The name recipients see next to your address. |
| Save sent mail to the Sent folder | Files a copy of mail your agent sends in Sent. Already off for Gmail and Zoho, which do this themselves; for other servers, turn it off if you see duplicates in Sent. |
Connections are always encrypted, and the mail servers must be reachable on the public internet — servers on a private or internal network can't be connected.
Sending email
Agents send through your SMTP server, from your address, so messages look exactly as if you sent them yourself.
- Replies stay in the original thread and default to the original sender and a
Re:subject. - Attachments come from files in the agent's workspace.
- If Save sent mail to the Sent folder is on, a copy is filed in Sent after the message goes out. If filing the copy fails, the send still counts as successful.
- If your mail server is too slow to respond, the agent is told the message may or may not have been sent and to check your Sent folder before trying again, so recipients don't get it twice.
Edit or test an email account
On the connector's detail view, each email account has Edit and Test connection actions. Edit lets you change the password or server settings — leave the password blank to keep the current one. Changing the IMAP or SMTP server or port needs the password entered again, so a saved password is only ever sent to the server it was saved for. Changes that affect how we connect are checked against your mail server before they're saved.
When an email account stops working
If your mail server rejects the login — for example after you revoke the app password — the account shows Login rejected, agents stop trying to use it (so your provider doesn't lock the mailbox), and the workspace owner gets one email about it. If the server can't be reached several times in a row, the account shows Can't reach server and the owner is told once. Fix it with Edit, or select Test connection once the problem is resolved.
Per-agent access
Access is granted per account, per agent. On a connector's detail view, each agent has a row where you pick which of that connector's accounts it can use. Toggle an account on for the agents that need it and off for the rest.
Manage accounts
From a connector's detail view you can:
- Rename an account.
- Remove an account, which revokes its access from every agent.
- Add account to connect another account of the same service.
When you remove a connector's last account, the connector auto-uninstalls from the workspace. You can also Remove the connector outright, which deletes all its accounts and revokes access from every agent.