Toolkit & Connectors
How Connectors Work
Overview
Connectors let Torki work with the apps you already use. You connect an app once in Toolkit → Connectors, then ask in plain language; Torki reads what it needs at the moment you ask and, with your approval, creates things in that app.
How it works
- You connect an app in Toolkit → Connectors and sign in on that app's own page.
- You ask Torki for something that needs it — "what's on my calendar this week?" or "what Linear issues are assigned to me?"
- Torki fetches the answer at that moment.
- If the request would write anything, Torki stops and shows an approval card first, unless you have set that tool to Always.
What it needs
Google Workspace is available on every plan, including Free. Microsoft 365 is included from Lite upward.
Get started
1. Open Toolkit → Connectors
Click Toolkit in the sidebar; Connectors is the first tab. The left side lists every app. Type in Search apps… to match on an app's name, category or description, or use the filters under it:
- All — everything.
- Connected — apps you have connected, including any that need reconnecting.
- Available — apps you can connect but have not.
- Soon — apps that are listed but cannot be connected yet.
Apps you have connected are grouped at the top under Connected, marked with a dot; the rest are grouped by category. An app whose sign-in has expired carries a Reconnect badge, and an app you cannot connect yet says Soon.
2. Open an app
Click an app to open its page on the right. The header shows its logo, name and category, with a Connect or Disconnect button. Below that:
- What it can do — a one-line description and a status pill: "Available to connect", "Connected · N tools", "Reconnect required" or "Coming soon".
- How Torki connects — starting with "Secure OAuth — you sign in on {app}'s own page; Torki never sees your password."
- Tool permissions — once the app is connected, every tool it offers, tagged Read or Write, each with its own setting.
Apps such as GitHub and Notion also have a link at the bottom to their own documentation.
3. Connect
Click Connect. The current tab goes to the app's own sign-in page, where you approve what Torki asks for. You are then brought back to Toolkit → Connectors with that app open and a short "{App} connected" message.
If you cancel on the app's page, you come back with nothing changed and no error. If the connection fails, Torki says "Couldn't connect — please try again."
Google Workspace and Microsoft 365 work differently: each of their services — Google Calendar, Google Drive & Docs, Google Sheets; Outlook Mail, Outlook Calendar, OneDrive — has its own row and its own Connect button, and connecting one does not connect the others.
4. Ask for something
Ask naturally. You do not need to name a tool: "What's on my calendar tomorrow?", "Summarise the Notion page about the launch", "Create a Linear issue for the login bug".
5. Approve anything that writes
Before Torki writes to one of your apps, it shows an approval card in the chat: the app's logo, the action (for example Create calendar event), "Wants to run this in Google Workspace", and a one-line description of exactly what it will do. Press Allow once to run it, Always allow to run it and stop asking for that tool, or Decline.
Nothing is written until you press one of the allow buttons. Declining leaves the note "Cancelled — nothing was changed." If one request needs several writes, each one gets its own card in turn. Reads run without a card.
See Controlling what Torki can do for the card and the per-tool settings in full.
What "Soon" means
An app marked Soon is in the directory but cannot be connected yet: its page has no Connect button and its status pill reads "Coming soon". Today that is Slack, Dropbox, HubSpot and Asana. Canva is listed the same way, and its page explains why: "Canva currently limits MCP access to approved partner apps." There are no dates for any of them.
For what each connectable app does, see Connecting GitHub, Notion, Linear and more.
Good to know
Reads and writes
Every tool is either a read or a write. For apps such as GitHub or Notion, a tool counts as a write unless the app itself marks it as read-only — so a tool you might think of as harmless can still ask for approval.
Privacy
Torki fetches your calendar, files, issues or pages at the moment you ask and keeps no separate copy of them. What does persist is the conversation itself — Torki's reply is saved with the chat, so anything it quoted back to you stays in that chat until you delete it.
Nothing from a connector is used to train Torki's model.
Disconnecting
Open the app in Toolkit → Connectors and click Disconnect (for Google and Microsoft, on the service's own row). See Managing your connectors.
FAQ
Can Torki read a document I already have in Google Drive?
No. It can only see files it created. Download the file and attach it to your message instead.
Can Torki send an email for me?
No. Torki cannot connect to Gmail, and sending Outlook mail is not built — it can only read your Outlook inbox.
Does declining an approval cost anything?
No. The action was never run.
Is Settings → Connectors gone?
No, it is still there and lists the same connections. The Toolkit is the fuller version: it has the app pages, the tool permissions and the Soon filter.