Connections
A connection is an account in another app that your agent can use for you: your email, your calendar, your documents, and many more. Once an app is connected, the agent can read and act in it when you ask, without you copying things across.
See what your agent can reach
Open the agent’s Credentials tab (from the Menu, Credentials (this agent)). At the top, What your agent can reach lists what the agent reported at the start of its last task:
- Credentials the agent holds: the names of keys and tokens it has. Names only; the values are never shown there.
- Connected accounts: each connected app, the account it is connected as (usually an email address), and its status, Active or Expired.
The list updates each time the agent starts a task. If it says Not reported yet, it fills in after the agent’s next run.
Connect an app
Ask in a thread: “Connect my Gmail”, “Connect my Google Calendar”, “Connect our Notion”. The agent sends you a link that opens that app’s own sign-in page. You sign in there; the agent never sees your password.
When you are done, tell the agent. It picks up the new connection on its next task, and the app appears under Connected accounts.
When a connection expires
Apps end connections from time to time: a changed password, a revoked permission, or a sign-in that simply ran out. The app then shows Expired under What your agent can reach, and the agent tells you it needs reconnecting instead of retrying.
Ask the agent to reconnect it (“Reconnect my Gmail”) and sign in again the same way. If a task fails because a key it holds stopped working, the reply shows a button such as Update the token in Credentials → that opens the right form.
Connections and credentials
Both give your agent access, but you set them up differently:
- A connection is made by signing in to the app itself. You never handle a key.
- A credential is a key or token you create in another service and enter in the credential form, for example your Claude sign-in, Slack tokens or a GitHub token. See Credentials.
If the agent needs a credential, it shows a button that opens the credential form. It never asks for the value in chat.
Drafting email
With your mailbox connected, ask the agent to reply to a message: “Draft a reply to Sam saying Thursday works.” It creates the draft in your own mailbox, ready to send:
- addressed to the person who wrote to you (and the others, for a reply to all);
- with the subject filled in as a reply to the original;
- with the original message quoted below its text.
The draft goes in the mailbox you name, or the one the original arrived in, and the agent tells you which mailbox and that it is in Drafts. Read it, and say “send it” when it is right. The agent sends exactly that draft and confirms it was sent. It never sends a draft you have not told it to send, and if it does not know who an email is for, it asks.
Next: Credentials · Automations · Inbox and approvals