itsbrill.ai

Appendix

Connector cheat sheets

A connector is the wiring that lets an AI assistant see and act inside one of your work tools: your inbox, your calendar, your files, your team chat. Once it's connected, you can ask the assistant things like "find the contract Sarah sent last week" or "draft a reply to this thread" and it can actually go and do it, instead of you copying and pasting everything in by hand.

This appendix is a quick reference. For each tool family I give you the same four things:

  1. The connector pattern to expect, which isn't a guarantee that your account has it today.
  2. The permissions to expect when you click connect.
  3. The first safe thing to try, so you can prove it works without risking anything.
  4. The one safety check that matters most.

One warning up front. This whole area moves fast. New connectors ship most months, names change, regions differ, and what's available today might need a paid plan next quarter. Treat every product-specific claim as a prompt to check the official docs and your workplace policy before you rely on it.

How connectors work (the 60-second version)

You don't need the plumbing, but two ideas will save you grief.

It uses your login and doesn't need a new one. When you connect a tool you go through a screen that says something like "this AI assistant wants to access your account". That's OAuth, a standard way to grant access without handing over your password. You can revoke it later from the same place you'd revoke any app.

It only sees what you can see. A well-built connector mirrors your existing permissions. If you can't open a folder in your shared files, the assistant can't either. It doesn't give you or the assistant access to anything you're not already allowed to see. That's a feature, and it's a big part of what makes them workable at work. It isn't the whole story, because a connector can still read everything you can, and some ask for broad access, so read the permission list every time. Using Microsoft 365 Copilot at work? My Copilot guide covers what it can reach.

Some connectors use shared standards so the same source app can plug into different assistants. You can ignore the protocol. The practical test is simpler: who built it, what can it read, what can it change, and how do you revoke it?

Most of these now run on a shared standard called MCP, which you'll see named in some settings screens. Connect your tools explains it in a sentence.

The universal first-day checklist

Before you connect anything, regardless of tool:

Email

Connector pattern

Email
PatternWhat it usually means
Personal email connectorRead/search email and create drafts, usually on a paid plan
Workplace account connectorReads work mail only when your organisation and admin policy allow it

At the time of writing, the first-party email connectors lean towards read and draft and leave send to you. In practice that means the assistant can search your mail, summarise a thread and write you a draft reply, but the actual "send" is left to you, or is gated behind an explicit approval step. That's deliberate, and it's the behaviour you want when you're starting out.

Permissions to expect

When you connect, the consent screen will usually ask to:

First safe thing to try

"Find the three most recent emails from [a specific person] and summarise what each one is asking me to do."

This proves the connection works, the assistant can search, and it's reading your real mail accurately, with zero risk because nothing leaves your outbox. Read the summary, then open the actual emails and check it didn't invent or miss anything.

The one safety check that matters most

Never let it send without you reading the draft first. Set the send action to "needs approval" (most connectors default to this, so confirm yours does). Email goes out under your name, and a wrong recipient or a misjudged tone can't be un-sent. Read every draft as if you wrote it, because as far as the recipient knows, you did.

Calendar

Connector pattern

Calendar
PatternWhat it usually means
Personal calendar connectorRead schedule, find free blocks and sometimes create events
Workplace calendar connectorSame pattern, but controlled by organisation policy and admin approval

Calendar connectors typically let the assistant read your schedule, find free slots and create or update events. Watch the difference between reading your calendar (very useful, low risk) and writing to it (useful, but it can send invites to other people, which is a write that leaves your account).

Permissions to expect

First safe thing to try

"What's on my calendar tomorrow, and where's my first free 90-minute block this week?"

Pure read. It's also one of the most useful things a calendar connector does day to day, so it doubles as a real test and a real win.

The one safety check that matters most

Watch out for invites that go to other people. Creating an event with attendees fires off emails to those people the moment it's saved. Before you let the assistant create meetings, ask it to confirm the title, time, and exact attendee list back to you, and to create the event without inviting anyone until you say so. A meeting on your own calendar is harmless. A garbled invite to a client at 6am is not.

Files: cloud files, shared drives and document libraries

Connector pattern

Files: cloud files, shared drives and document libraries
PatternWhat it usually means
Personal cloud filesRead/search files you can already open
Shared drives and document librariesRead/search only where your account already has access, often admin-controlled

File connectors are where these tools earn their keep: "find the latest version of the pricing deck", "summarise this 40-page report", "pull the numbers from last quarter's spreadsheet". A useful detail at the time of writing: the first-party file connectors are strong on read and search but thinner on file management. Moving, renaming, deleting and re-foldering files are often missing or limited. So they're great at finding and reading, less so at tidying up. That's fine, because reading is the valuable part.

Permissions to expect

For your shared files, remember it mirrors your existing access. You won't suddenly be able to read a locked HR folder, and neither will the assistant.

First safe thing to try

"Search my files for the most recent version of [a document you know exists] and give me a three-bullet summary."

If it finds the right file and the summary matches reality, you're connected and it's reading accurately. The "matches reality" part is the test, so pick a document you actually know.

The one safety check that matters most

Confirm it found the right file before you trust the summary. The classic failure isn't a security breach, it's the assistant confidently summarising the wrong document, an old version, or a similarly named file. Always make it name the exact file (and ideally the date or folder) it's reading from. If you're about to make a decision off that summary, open the file yourself first. The connector is a research assistant and isn't a source of truth.

Chat: work chat

Connector pattern

Chat: work chat
PatternWhat it usually means
Work chat connectorSearch channels and threads your account can already see
Enterprise search connectorBroader workplace search, usually admin-controlled and policy-gated

Chat connectors let the assistant read channels and threads, search history, and post messages. They're handy for "catch me up on the #project channel" or "draft a status update". They're also the connector where a mistake is most visibly public.

Permissions to expect

First safe thing to try

"Summarise what happened in [a specific channel] over the last two days. Don't post anything."

The "don't post anything" is doing real work in that sentence. Get comfortable with reading and summarising before you ever let it write.

The one safety check that matters most

Posting to chat is instant and public. Many work chat apps keep an unsent draft, and once a message is sent the whole channel has seen it. A vague instruction like "post an update" can land in the wrong channel in front of the entire company. So keep writing off until you trust it, and when you do turn it on, always make the assistant tell you the exact channel and the exact message before it sends. Treat every "post this" like hitting send on an all-staff email.

Notes and project folders

Connector pattern

Notes is the most fragmented category, because "notes" means very different products.

Notes and project folders
PatternHow it usually connects
Workspace notes appOfficial or workplace-approved connector where available
Plain-text project folderAny approved assistant with access to that specific folder can read the files
Work notebookOften reachable through your organisation's approved account connector
Consumer notes appPatchier, so check current support before assuming

The catch worth knowing: notes connectors are usually the fiddliest of the lot, because each notes app handles workspaces, tokens and permissions differently. Budget a bit of patience, and don't be surprised if a notes connector takes three goes when email took one.

Permissions to expect

First safe thing to try

"Search my notes for notes about [a project] and list the relevant pages with a one-line summary of each."

Read-only, and it tells you immediately whether it's seeing the right workspace.

The one safety check that matters most

Notes are often your messiest, most personal data, so scope it tightly. Half-finished ideas, meeting notes, personal to-dos, the occasional thing you'd never want in a work summary. Before connecting, decide which workspace or which folder the assistant gets, and give it only that. For local folders especially, point it at a specific project folder, not your whole drive. The goal is for it to read your project notes and nothing else.

Work accounts and office suites

Quick reference: the whole appendix on one screen

Prints on one page.

Quick reference: the whole appendix on one screen
Tool familyLower risk (read)Be careful (write)The one check
EmailSearch, summarise, draftSendRead every draft before it sends
CalendarRead schedule, find free timeCreate events with attendeesConfirm attendees before inviting
FilesSearch, read, summariseMove and delete (often limited anyway)Confirm it found the right file
ChatRead channels, summarisePost messagesPosts are instant and public
NotesSearch, read pagesCreate and edit pagesScope it to the right workspace only

A note on staying current

I last went through this on 2 November 2026 and the patterns held up. Product details change often, so parts of it will be wrong by the time you read it. The pattern, though, is stable and worth internalising:

When in doubt, check the official help pages for your assistant and your tool, and check with your IT admin if it's a work account. The five-minute conversation is cheaper than the connector that quietly had more access than you thought.

Enter to openEsc to close