Skip to main content

Connectors and Connected apps

OnEarly connects to other software in two directions, and each has its own place in Account settings.

  • Connectors bring an outside account, such as your email or calendar, into OnEarly so the OnEarly Agent can use it.
  • Connected apps are outside applications you have let in to use your OnEarly account, for example an AI assistant working through OnEarly's tools.
Connectors and Connected apps
Connectors and Connected apps

Connectors​

Manage connectors in the web app under Account → Connectors. Connectors are not available in the iOS and Android apps, but connectors you add on the web still work in your threads there.

Add a connector​

  1. Open Account → Connectors in the web app.
  2. Choose a service from the catalogue, or Add custom connector.
  3. Sign in to the service and approve access.
ServiceNotes
Gmail
Google Calendar
Google DriveRead-only
Outlook
Outlook Calendar
OneDriveRead-only
Notion
Linear

You can connect more than one account for the same service. When you ask the OnEarly Agent to send email and you have several accounts for that service, it asks which one to use.

A custom connector takes a name and a server URL, then signs you in to that server.

Group connectors​

Group admins can add connectors for a group under Group settings → Integrations. A group's connectors are used by the group's admins, not by every member: an admin's OnEarly Agent can use them alongside the admin's own connectors, in threads started in that group. There, a group connector takes the place of the admin's own connector for the same service. A group's API key uses only that group's connectors.

When a connector expires​

If a connector stops working, the OnEarly Agent asks you to reconnect it. Open Account → Connectors in the web app and reconnect.

Connected apps​

When an outside application asks to use your OnEarly account, OnEarly shows a sign-in and consent screen. The screen shows:

  • the application's name;
  • a Verified badge, or Unverified application if OnEarly does not recognise it;
  • the address you will be sent back to after you approve;
  • what the application is asking for.

Verified means OnEarly recognises the application. It is a label to help you decide, not a guarantee: an unverified application can still ask, and you choose whether to allow it. Check the name and return address before approving.

What an application can ask for​

PermissionWhat the consent screen says
Full accessFull access to OnEarly as you
IdentityConfirm who you are
EmailSee your email address
ProfileSee your name
Staying signed inStay connected

An application with full access works as you: it can see and do what you can, through OnEarly's tools.

See and revoke access​

Open Account → Connected apps. Each application you have allowed shows:

FieldMeaning
Verified or UnverifiedWhether OnEarly recognises the application.
Connected dateWhen you first allowed it.
Last used time agoWhen it last used your account, if known.
Full access, or Access: permissionsWhat it can do.

To take access back:

  1. Choose Revoke next to the application.
  2. Confirm with Revoke access.

Access stops straight away. The application has to ask you again to get it back. If you try too many times in a short period, the page shows how long to wait before trying again.

OnEarly's own apps can't be revoked here.

API keys​

API keys let your own software use OnEarly. Create them under Account → Developer (personal keys) or Group settings → Developer (group keys, for group admins; see who can create them). A new key is shown once, so store it securely. You can set a date the key stops working; it keeps working until the end of that day in your time zone.

A personal key works only with OnEarly's MCP tools. A group key acts as the group.

Key permissions​

When you create a key you can limit what it can do. Permissions only narrow what the key's owner can already do, never widen it. Choose at least one: a key with none could do nothing.

SectionPermissionPersonal keyGroup key
GroupsGroups: createYes (creates groups through MCP)Yes
GroupsGroups: deleteNoYes
GroupsGroups: listNoYes
MCP built-in toolsContent: search and readYesYes
MCP built-in toolsContent: createYesNo
MCP built-in toolsGroups over MCP: listYes (your groups)Yes (this group)
Connected accountsOne switch per connector toolAccounts you connected, and those of groups you administerAccounts connected to this group

MCP tools you leave off are neither listed nor callable with that key. The key list shows each key's permissions by these names, or Full access.

For key formats and scopes, see Authentication.

What we're working on​