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, Settings). The Connected apps card lists each app your agent can use:
- Its name: you name each connection when you add it, so two accounts of the same app (a work and a personal Gmail, say) are easy to tell apart. Rename it any time.
- Its status: Connected, or Expired when it needs signing in again.
Under the list, a line says when your agent last checked its connections. It checks each time it starts a task, so a new connection shows up for it on its next task.
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.
You can also press + Connect an app on the Connected apps card. When you are done, the card asks you to name the connection, and the agent picks it up on its next task.
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 Connected apps, 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