Connectors Reference

Connectors are external accounts and data sources that a user links to Configure. Gmail, Calendar, Drive, and Notion are connectors. Model-callable functions are tools.

Use profile.tools() to expose connector-backed tools to a model, and profile.executeTool() to run tool calls. Connector tools are never included by default.

const tools = profile.tools({
  connectors: ["gmail", "calendar", "drive", "notion"],
});

Supported Connectors

Connector	Tool name	Purpose
Gmail	configure_gmail_search	Search connected email when explicitly enabled.
Calendar	configure_calendar_get	Read connected calendar events when explicitly enabled.
Drive	configure_drive_search	Search connected files when explicitly enabled.
Notion	configure_notion_search	Search connected Notion pages when explicitly enabled.

Connector results depend on user consent and account connection state. If a connector is enabled for the runtime but the user has not connected that account, executeTool() returns a connector error instead of silently falling back to profile memory.

Actions

Actions can change external state, so they are opt-in separately from connector reads.

const tools = profile.tools({
  actions: ["email.send", "calendar.create_event"],
});

Action	Tool name	Purpose
email.send	configure_email_send	Send email after your application has collected user approval.
calendar.create_event	configure_calendar_create_event	Create a calendar event after user approval.

profile.executeTool() rejects action tools that were not enabled for the current profile runtime handle.