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
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
- Open Account → Connectors in the web app.
- Choose a service from the catalogue, or Add custom connector.
- Sign in to the service and approve access.
| Service | Notes |
|---|---|
| Gmail | |
| Google Calendar | |
| Google Drive | Read-only |
| Outlook | |
| Outlook Calendar | |
| OneDrive | Read-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
| Permission | What the consent screen says |
|---|---|
| Full access | Full access to OnEarly as you |
| Identity | Confirm who you are |
| See your email address | |
| Profile | See your name |
| Staying signed in | Stay 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:
| Field | Meaning |
|---|---|
| Verified or Unverified | Whether OnEarly recognises the application. |
| Connected date | When you first allowed it. |
| Last used time ago | When it last used your account, if known. |
| Full access, or Access: permissions | What it can do. |
To take access back:
- Choose Revoke next to the application.
- 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.
| Section | Permission | Personal key | Group key |
|---|---|---|---|
| Groups | Groups: create | Yes (creates groups through MCP) | Yes |
| Groups | Groups: delete | No | Yes |
| Groups | Groups: list | No | Yes |
| MCP built-in tools | Content: search and read | Yes | Yes |
| MCP built-in tools | Content: create | Yes | No |
| MCP built-in tools | Groups over MCP: list | Yes (your groups) | Yes (this group) |
| Connected accounts | One switch per connector tool | Accounts you connected, and those of groups you administer | Accounts 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.