Integrations

The integrations provider lets your app act in the person's own accounts at other services, with the person's consent for each service.

Scopes

• integrations:discover allows search and schema, which find services and their tools, and the link group's accounts, which lists the person's linked accounts.
• integrations:<service>_read and integrations:<service>_write gate each service's tools. For example, a service named gmail has integrations:gmail_read and integrations:gmail_write.

Scope strings come from What it asks for → Add permissions (provider integrations). The catalog is large, so search it by service name.

Find the tool you need

The provider has thousands of tools: on 2026-10-16 the runtime we captured from listed 3,061 tools across 3,060 groups, one _read group and one _write group per service, plus discover and link. This page does not table them. List them from your app:

const integrations = await runtime.providers.tools('integrations');
for (const group of integrations.groups) console.log(group.group, group.leaves.map((leaf) => leaf.tool));

providers.tools('integrations') is large (several megabytes on that runtime), and it lists only groups your app's grant holds, so it stays small until you add service scopes. To find a service or a tool, call the provider's search and schema tools (group discover) instead of reading the whole list.