Connectors

Connectors let Yori work with the other apps you use, such as Gmail, Google Calendar, Google Drive and Notion. Connect an account once, switch on the actions you're happy for Yori to take, and then ask for things in plain language in chat.

Where to find it

Open Knowledge in the sidebar and choose Connectors. Connectors opens as a window over the page you're on, so you don't lose your place. You can also choose Connectors from the section toggle on any Knowledge page.

Who can use Connectors

• Connectors are included on every plan, including the free trial.
• Each connection is private to you, in the workspace you're using. Teammates can't see or use your accounts, and you can't use theirs. Each person connects their own.
• Connections belong to the workspace you made them in. If you work in more than one workspace, connect your accounts in each one.
• If you see "Connectors aren't set up yet. Ask a Yori administrator to finish setup.", Connectors aren't available in this environment yet.

Browse the catalogue

The Connectors window shows:

• An installed summary near the top, with the logos of apps you've added and a count such as "3 installed". Select it to see only your installed apps, and select Back to all connectors to return.
• Add custom, to connect your own MCP server. See Add a custom connector.
• Search connectors, which matches app names, descriptions and categories.
• Category buttons: All, Featured, then marketing categories such as Marketing automation, Email marketing, Social media, CRM and sales, Advertising, Analytics and reporting, Content and design, Websites and landing pages, Forms and surveys, Events and webinars, Calendar and scheduling, Documents and files, Projects and tasks, Team chat, Ecommerce and Customer support. Select View all to see every category, and Show less to fold them away.
• Rows of apps grouped by category. Featured includes Gmail, Google Calendar, Google Drive and Notion.

Each app shows its logo, name and a short description. Apps you've added show a green tick and Added. Others have an Add button. Apps outside the marketing categories, such as developer tools, are still available through search.

Connect an app

1. Find the app and select Add.
2. A new browser tab opens so you can sign in to the app, or enter its key if the app asks for one. Approve access.
3. Return to the Yori tab. Yori checks the connection when you come back.
4. When it works, you'll see "App connected. Choose which of its tools Yori can use."

If nothing opens, your browser may have blocked the sign-in tab. Allow pop-ups for Yori, then try again. If you don't finish signing in, the Add button resets after about two minutes so you can start again.

New connections start with every tool switched on. Switch off anything you don't want Yori to do. See Choose what Yori can do.

Add a custom connector

If a service you use has its own MCP server, you can connect it to Yori even when it isn't in the catalogue. A custom connector is private to you, like every other connection.

1. Select Add custom near the top of the Connectors window.
2. Enter the Server address, the full public address of the server starting with https://. It often ends in /mcp.
3. Optionally give it a Name. Without one, Yori uses the server's address.
4. Choose how it signs in under Sign-in. The options are below.
5. Select Add server. Yori checks the server, which can take a few seconds, then opens its details page.

Option	When to use it
Detect automatically	Most of the time. Yori checks the server and picks the right sign-in.
Sign in with the service	The server lets you sign in on the service's own page.
API key	The service gave you a key. Paste it in API key. You can name the Key header if the service asks for one; otherwise the key is sent as a bearer token.
No sign-in	Public servers that anyone can use.

A server with no sign-in, or with an API key the server accepts, is ready straight away, with every tool switched on. For a server that signs in with the service, select Sign in on its details page and approve Yori on the page that opens. If Yori detected that a server needs an API key, its details page asks for one: paste it in API key and select Save key. Its tools appear once you're connected. Yori never shows a saved key again.

Your custom connectors appear under Your custom connectors at the top of the catalogue. Their details page shows the server's address and these buttons:

• Refresh tools: Yori reads the server's tool list again, for example after the server adds new tools. Tools that haven't changed keep your settings. New and changed tools start switched off until you switch them on.
• Remove: removes the server, its sign-in or key, and its tool settings. You can add it again at any time.

You can add up to 10 custom connectors in each workspace. When Yori uses a custom connector, it sends the details needed for each request to that server, so only add servers you trust.

View an app's details

Select an app's name or logo to open its details page. It shows:

• The app's logo, name, a Visit link to the app's own website (for example Visit Notion), and its description.
• Add if you haven't connected it yet. Once connected, Share and Uninstall appear instead.
• Accounts: every account you've connected for this app, with its status.
• Tools: the actions Yori can take in the app.
• Categories: the categories the app belongs to.

Select the back arrow to return to the catalogue.

Share copies a link to this app's page in Yori. When a teammate opens it, Yori opens Connectors on the same app so they can connect their own account.

Account statuses

Status	What it means
Connected	Working. Yori can use it with the tools you've switched on.
Disconnected	No longer linked. Reconnect it to use it again.
Needs attention, or another status in amber	The connection isn't fully working, for example sign-in expired. Add the account again.

In the installed list, each app shows how many accounts and tools it has, for example "2 accounts, 40 tools", and its overall status.

Add more accounts

You can connect more than one account for the same app, such as a personal and a shared Gmail inbox.

1. Open the app's details.
2. Under Accounts, select Add another account.
3. Sign in with the other account.

Accounts without a name show as "Connected account 1", "Connected account 2" and so on. Select an account to see and change its tools. Each account has its own tool settings.

Choose what Yori can do

The Tools section lists every action Yori can take in the app, for the selected account. It's collapsed at first and shows a count such as "40 tools available".

• Select the count, or the arrow, to open the list. A Search tools box appears.
• Enable all switches every tool on. Clear all switches every tool off.
• Tools are grouped into Read actions, Create actions, Update actions, Destructive actions and Other actions. Each group shows how many are on, for example "3 of 12 on", and has its own switch to turn the whole group on or off.
• Open a group to switch single tools on or off.
• Some tools carry an extra note. File upload means the tool can send a file. In Other actions, notes such as Communicates externally or Review required tell you what to watch for.

Changes save as soon as you flip a switch. If a save fails, you'll see "Tool settings could not be saved" and the switch goes back.

Before you connect, the details page shows a read-only list of the tools Yori could use once connected, with Search tools.

Be careful with powerful tools

Yori runs any tool you've switched on without asking you first. A switched-off tool can't run at all. Start with Read actions and add others only when you need them. Think carefully before switching on Destructive actions, such as deleting records, or tools that send messages to other people. Enable all switches these on too.

Some tools stay greyed out and can't be switched on. These aren't available to Yori right now.

Use connected apps in chat

Once an account is connected and its tools are on, ask Yori in ordinary language in any chat. For example:

• "Find the last three emails from our printer in Gmail and summarise them."
• "Add a launch review to my calendar next Tuesday at 10."
• "Save this brief to my Notion workspace."

Yori finds the right tool for the job and uses the account you connected. If the tool it needs is switched off, Yori can't use it. Switch the tool on in Connectors, then ask again. Some tools can use files from your project, such as attaching a document. Chat messages that use connected apps use credits in the normal way.

Disconnect or uninstall

• Disconnect one account: in the app's details, hover the account and select the bin icon, then confirm Disconnect. "Yori will lose access to this account. You can reconnect it at any time."
• Uninstall the app: select Uninstall on the details page and confirm. Yori disconnects every account for that app.
• Remove a custom connector: select Remove on its details page and confirm.

Other accounts and apps aren't affected.

Troubleshooting

• "Couldn't load connectors": select Try again, or close and reopen Connectors.
• "Yori could not connect this app": the sign-in wasn't completed. Select Add and try again.
• "Connection finished. Yori is updating its status.": wait a moment. The status updates on its own.
• "No connectors found": try a different search or category.
• "This address didn't answer as an MCP server": the address opened something else, such as a web page. Check you entered the server's full MCP address, often ending in /mcp.
• "Yori couldn't reach this server": the address may be wrong, the server may be down, or it isn't public. Yori can only connect to servers on the public internet. For a connector you added earlier, check the server is running, then try again.
• "The server refused Yori's sign-in": for an API key, check the key, and the Key header if the service names one, then try again. For a server you signed in to, select Sign in on its details page.
• "This server doesn't support OAuth sign-in that Yori can use": choose API key instead and use a key from the service.
• "Yori couldn't add custom connectors right now": something went wrong on Yori's side, not with your server. Try again in a moment.
• "Sign in to … again", naming one of your custom connectors: the service ended Yori's sign-in. Open the connector's details page and select Sign in.

Related guides

• Chat and messages
• Services, credits, and ownership
• Automations
• Permissions, ownership, and sharing