Your day / Your own integrations

Your own integrations.

Connect your own tools in Settings > You > Integrations. A connection there belongs to you, not to a workspace: agents act as your own account, with your permissions. Teammates and workspace admins cannot see, use or disconnect it, and it never appears on a workspace's Integrations page. It follows you into every workspace you belong to; see Who can use a connection.

Your GitHub Connection has its own row in the same list; see Import a repository. For an organization tool such as Sentry for your own work, choose Personal in Settings > Workspace > Integrations instead.

Connect a tool

Settings > You > Integrations, reading Your integrations, with a search field and the All, Needs attention, Connected and Not connected filters. GitHub and Telegram read Connected, and the tools below them read Not connected.

  1. Open Settings > You > Integrations, and search the list or filter it with All, Needs attention, Connected or Not connected.
  2. Click the tool's row, then press Connect, such as Connect Gmail.
  3. Sign in on the tool's own page and approve its default permissions, or enter the key it asks for.
  4. Back in Settings, the card reads Connected as followed by the account, when the tool names one.

Telegram, WhatsApp, Excalidraw, LinkedIn and X connect in a dialog instead; see their sections below. An unfinished authorization lapses after 10 minutes; press Cancel to drop it sooner. Sensei can also offer a Connect button in a thread when a task needs a tool.

Find a tool that is not listed

A search also looks in the workspace's integrations, the workspace picked under Workspace in Settings. A match there shows under a heading such as In Acme workspace integrations, with Open in Workspace. Only a workspace admin can connect it there.

Under All, the list also shows tools Composio offers that Sensei does not support yet. Such a row has only Request integration, which sends Sensei the request and then reads Requested. For anything else, Request integration after "Missing an integration?" above the list opens an email to support@kosuke.ai.

Connect more than one account

Every tool except WhatsApp, Excalidraw, Higgsfield, 1Password and Typefully can be connected more than once, for example two Google accounts. Press Add another connection on a connected row. Each connection is its own card.

Each card has a label, read from the tool where it can be, such as your mailbox address for Gmail. Google Docs, Sheets, Slides, Calendar, Meet, Jira, Confluence and Fathom ask you to type one. Rename a card with its pencil icon, except Telegram, WhatsApp and Excalidraw. Connecting an account twice is refused for most tools; re-authorizing a Notion workspace can instead sign out the earlier card, which then needs Reconnect.

Agents pick a connection by its short id or scope:label, such as personal:work@example.com, as each card shows.

Catalog

Agents can use every action Sensei offers for a tool: reads, creates and updates. Actions that delete are never offered, and a sent request, such as a mail, cannot be recalled.

ToolConnects withWhat Sensei can doNotes
GmailGoogle sign-inRead, search, draft and send mail; unsubscribe from newslettersWatched messages
Google DriveGoogle sign-inFind, read and organize files
Google DocsGoogle sign-inRead and edit documentsType a label
Google SheetsGoogle sign-inRead and edit spreadsheetsType a label
Google SlidesGoogle sign-inRead and edit presentationsType a label
Google CalendarGoogle sign-inRead and manage eventsType a label; events can carry a Meet link
Google MeetGoogle sign-inRead past meetings, transcripts and Gemini notes; create spacesTranscripts only for meetings with transcription on
YouTubeGoogle sign-inUpload and manage videos, playlists and comments
DropboxOAuthSearch, download, upload, move and rename filesNo sharing or shared links
SlackOAuthRead channels, DMs and files; post messages and reactions as youWatched messages; see Slack
TelegramPhone code or QR codeRead chats, contacts and stories; send, forward, edit and delete your messagesWatched messages; see Telegram
WhatsAppQR code or pairing codeRead stored chats; send as youWatched messages; against WhatsApp's terms; see WhatsApp
LinkedInSensei's browser on your MacWork in your account; read new direct messagesNeeds a Mac; see LinkedIn and X
XSensei's browser on your MacWork in your account; read new direct messagesNeeds a Mac; see LinkedIn and X
ExcalidrawNo sign-inCreate diagrams, share links, extend a shared drawingSee Excalidraw
LinearOAuthRead, create and update issues, projects and commentsOne Linear workspace per connection
JiraAtlassian OAuthRead issues, boards and sprints; create and update issues and commentsOne Jira Cloud site per connection
ConfluenceAtlassian OAuthRead spaces, pages and comments; create and update pages; commentOne Confluence site per connection
AsanaOAuthRead projects and tasks; create, assign, complete and comment on tasksReaches every Asana workspace of your login
ClickUpOAuthRead tasks, docs and chat; create and update tasks, comments and docsCannot send chat messages or archive
FigmaOAuthRead files, components and comments; render images; commentReaches every file your account can open
NotionOAuthSearch and read pages, databases and comments; create and update themOnly the pages you share at sign-in
AttioOAuthRead, create and update records, lists, notes and tasksAdmin approval may be needed; can reach the whole workspace
SalesforceOAuthQuery, create and update records; run reports; send emailEnter your My Domain if your org needs it
Zoho CRMOAuthRead, create and update records and notes; convert leadsEnter your Zoho data center first
Zoho BooksOAuthRead the books; create and update contacts, estimates and payments; email invoicesEnter your Zoho data center first; no one-off invoices
Zoho InvoiceOAuthRead, create and update invoices, estimates and payments; email invoicesEnter your Zoho data center first
XeroOAuthRead, create and update invoices, bills and payments; read reportsChoose the organisations at sign-in
QuickBooksOAuthRead reports; create and update customers, invoices and billsOne company per connection; keep the default URLs
FreshBooksOAuthRead businesses, clients, projects and journal entriesRead only
MercuryOAuthRead accounts, transactions and statementsRead only; reads show full account numbers
RhoAPI access tokenRead accounts, transactions and statementsRead only; see Tools that take a key
GranolaOAuthRead meeting notes, summaries and transcripts; ask about your meetingsRead only
FathomOAuthRead meetings, summaries and transcripts; get recordingsRead only; type a label
ZoomOAuthRead meetings, summaries and recordings; schedule a meetingA company Zoom admin may need to allow the app
Microsoft TeamsOAuthRead teams, chats and meetings; post and reply; create chats and tasksA Microsoft 365 admin may need to approve
OutlookOAuthRead, draft and send mail; manage events and contactsA Microsoft 365 admin may need to approve
CalendlyOAuthRead events and availability; create event types and links; book meetingsNo cancel or reschedule links in answers
CanvaOAuthRead and export designs; create designs; upload assets; commentSome actions need a paid Canva plan
MiroOAuthRead boards and items; create boards and add or update itemsOne Miro team per connection
MondayOAuthRead boards and items; create items; post updatesA monday.com admin may need to install the app
TypefullyAPI keyRead social sets and drafts; create, schedule and publish postsPosts go out as you; one connection
HiggsfieldAPI key ID and secretGenerate images and videos; create Soul ID charactersSpends your Higgsfield credits; one connection
1PasswordService account tokenList vaults and items; read items, secrets includedRead only; one connection
CloudflareGlobal API Key and emailManage DNS, Workers, Pages and KV; read traffic and Worker analyticsOne Cloudflare account per connection; see Cloudflare

Many consent screens name Composio, the service Sensei connects through.

Slack

Agents act in Slack as you: they reach every channel, conversation and file your account can read, direct messages included, and what they post shows as yours. Teammates on the same Slack each connect their own account.

Telegram

  1. Open the Telegram row and press Connect Telegram. A dialog opens.
  2. Enter your phone number in international format, such as +44 7700 900123, and press Send code.
  3. Type the code Telegram sends to your other devices or by SMS.
  4. If your account has two-step verification, enter its password and press Log in.

If the code does not arrive, press Log in with QR code instead and scan it from Telegram > Settings > Devices > Link Desktop Device. A login idle for 5 minutes expires. An account already connected by you or a workspace member is refused.

Agents read your chats, contacts and stories, transcribe media, and send, forward and react as you. They edit and delete only messages you sent, and cannot join chats or change your profile. Reading marks nothing read, and the session stays encrypted on Sensei's server.

Reconnect. If you end Sensei's session in Telegram's Settings > Devices, the card reads Reconnect required: press Disconnect, then Connect. Disconnecting also ends the session in Telegram.

WhatsApp

WhatsApp connects as a linked device. Automating a personal WhatsApp is against WhatsApp's Terms of Service and can get your number restricted or banned, so you accept that risk each time you link. WhatsApp Business is not offered.

  1. Open the WhatsApp row, press Connect WhatsApp, accept the risk and press Continue.
  2. On your phone, open WhatsApp > Settings > Linked devices > Link a device, and scan the QR code.

Or press Link with phone number instead, enter your number, press Get code, and enter the eight-character code under Link a device > Link with phone number instead on your phone.

Sensei stores 1:1 and group messages for 14 days, starting with the recent history WhatsApp sends at linking. Agents read those, transcribe attachments, and send text or files as you. They never reach status updates, broadcast lists or channels.

Paused. At the first restriction or ban signal, Sensei stops reading and sending. Press Resume to continue from the stored session.

Reconnect. If you remove Sensei from Linked devices, or the phone is offline for about 14 days, press Disconnect, then Connect. Disconnecting deletes the stored messages and contacts.

Excalidraw

Open the Excalidraw row, press Connect, read the dialog and press Connect again. No Excalidraw sign-in is needed.

Agents share diagrams as encrypted excalidraw.com links. Anyone holding a link can open it, and Sensei cannot delete it, even after Disconnect. Agents can extend a drawing you shared with Share > Export to link, returning a new link. They cannot reach your saved Excalidraw drawings, live #room= links or drawings with images.

LinkedIn and X

A LinkedIn or X connection is one account in Sensei's browser on one Mac and Chrome profile. Only your Sensei uses it.

  1. On a computer, press Connect on the LinkedIn or X row.
  2. Choose an online Mac and a Chrome profile you allowed under Settings > Devices > Chrome sign-ins.
  3. Press Connect. Sensei opens the site there and reads the account. If you are signed out, it asks you to sign in on that Mac.

If the site later shows another account, Sensei does nothing as it and the card reads Different account. See Watching for direct messages.

Apple apps

In the desktop app on your Mac, the same list has Apple Reminders, Apple Notes, Apple Calendar, Apple Contacts, Apple Messages and Apple Location. Each is off until you switch it on, and macOS asks once. Only your own Sensei uses them. See Apple apps.

Message watching

Sensei watches new messages on Slack, Gmail, Telegram, WhatsApp, LinkedIn and X only for the connected services you turn on in Settings > You > Preferences > Message watching. Every service starts off. Turning one off disconnects nothing. See Watching for what Sensei reads on each service and Triage and the FYI digest for what happens to each message.

Tools that take a key

These tools take a key on the page that opens. To change one, press Disconnect, then Connect; for Rho, paste a new token on the same card.

  • Higgsfield: an API key ID and secret from Higgsfield's API Keys page.
  • Typefully: an API key from Typefully's Settings > API.
  • 1Password: https://my.1password.com as Base URL and a service account token, reading only the vaults agents need.
  • Rho: a read-scoped rhobat_ token, which an Account Owner or Admin creates in Rho under Settings > Configurations > Access Tokens. It expires at its set date or after 45 days unused.

Cloudflare

  1. Open Cloudflare's row and press Connect Cloudflare.
  2. Enter your Global API Key and the email of the Cloudflare login it belongs to. A scoped API token does not work.
  3. Pick the account agents may use, from the first 50 accounts of the login.

The key reaches every account of its login, so Sensei holds agents to the one you pick. For the best protection, use a Cloudflare user that belongs to only that account. Add one connection per account.

Agents cannot delete, manage tokens or secrets, create zones, purge the cache, manage Worker routes, read R2 objects or run D1 queries. One call carries at most 64 KB. If the key is revoked, press Disconnect, then Connect with the new one.

Who can use a connection

Your connections serve turns you started: your Sensei, tasks you are the Assignee of and the Delegated Runs they start. Say "my Linear" for yours and "the workspace's Sentry" for a workspace one. An API key can also list and call them; see Run integration tools.

Nobody else gets them:

  • A turn a teammate sent in your session acts as the workspace.
  • Workspace Crons, Deploy Chat and unassigned work use workspace integrations only. A Personal Cron uses yours.
  • A teammate's agents never reach your connection, even in a shared project.

What an agent reads can show in the session's messages, which teammates can read.

Connection status

StatusWhat it meansWhat to do
Not connectedNothing is connected.Press Connect.
ConnectingAn authorization is waiting to be finished.Finish it, or press Cancel.
Connected as <account>Agents act as the account shown.Nothing.
Temporarily unavailableThe tool could not be reached just now.Try again shortly.
Reconnect requiredThe authorization stopped working.Press Reconnect, or Disconnect then Connect for tools that take a key, Telegram, WhatsApp, LinkedIn and X.
PausedWhatsApp signalled a restriction or ban.Press Resume.
Not availableYour deployment does not offer the tool.Ask whoever runs your deployment.

Disconnect

  1. Open the tool's row and press the trash icon on the connection's card.
  2. In the dialog, press Disconnect.

Agents lose access at once, in running tasks too. Revoking the authorization inside the tool is a separate step there. Leaving a workspace needs no disconnect; deleting your account disconnects everything. From a script, use kosuke integrations connections delete personal <toolkit> --connection-id <connectionId>.

Limits

  • Connecting needs your browser. An API key can only list and disconnect.
  • One unfinished authorization and one Telegram login at a time; starting another ends the first.
  • Telegram: 3 login codes an hour per number; 10 sends a minute and 200 a UTC day per account.
  • WhatsApp: 10 link starts and 3 pairing codes an hour; 5 sends a minute and 50 a UTC day, one at a time.
  • Telegram and WhatsApp files up to 20 MB, transcription up to 10 MB.
  • Excalidraw: 10 shares a minute and 200 a UTC day.
  • Sensei never enters X's encrypted-chat passcode. If X Chat asks for it, unlock X Chat on your Mac.

Next steps