engenty wizards

Connectors

Services a wizard works in for the person who runs it – built in, from the registry or over MCP.

v0.5.0

Settings → Connectors lists the services the space’s wizards can work in. A wizard uses a connector with the account of the person who runs it: they connect their account during the run, on a page that asks for it. Each space has its own connectors. In a team on engenty.ai, the owner and the admins add and remove them. In the cloud, a space you publish from your computer shows its connectors without letting you change them: you change them on your computer.

Built in

ServiceThe person signs in with
Gmail, Google Drive, Google Calendar, Google ContactsGoogle (OAuth)
Outlook, OneDriveMicrosoft (OAuth)
SlackSlack (OAuth)
GitHubGitHub (OAuth)
HubSpotA token they enter
S3Keys they enter

The OAuth services need an OAuth client of your own, which you enter in the settings file of engenty wizards. A built-in connector shows up in the list once it can be connected, so a service without its client doesn’t appear. Google is the exception on your computer: without a Google client of your own, Gmail, Drive, Calendar and Contacts connect through your engenty account, which holds the client. Connecting then asks you to sign in to the account first (Settings → Account).

ServiceSettings
GoogleGOOGLE_OAUTH_CLIENT_ID, GOOGLE_OAUTH_CLIENT_SECRET
MicrosoftMICROSOFT_OAUTH_CLIENT_ID, MICROSOFT_OAUTH_CLIENT_SECRET
SlackSLACK_OAUTH_CLIENT_ID, SLACK_OAUTH_CLIENT_SECRET
GitHubGITHUB_OAUTH_CLIENT_ID, GITHUB_OAUTH_CLIENT_SECRET
  • Give each client the redirect address <your address>/api/connect/callback. CONNECT_REDIRECT_URL sets a different one.
  • For Google, enable the APIs you use and add their scopes to the consent screen.
  • A connection asks only for what the wizard’s actions need.

You find the settings file under Command line.

From the registry

Any other service comes from the integrations.sh registry:

  1. Search for the service, for example Notion or Stripe.
  2. “Import” adds it from its API description or its MCP server.
  3. Its actions appear, marked as “reads”, “changes” or “deletes”. Some services list them only once an account is connected. “Reload actions” asks the service again.

If a service needs an OAuth client of your own, it says so. Remove it and import it again with “Your own OAuth client”.

The editor’s chat does the same while it builds a wizard: ask it to work with a service, and it finds and imports the connector. An AI app connected to engenty wizards can do this too.

What a wizard may do

A wizard names the actions it uses. Without a list, it uses only the actions that read. During a run:

The actionWhat happens
ReadsIt runs without asking, unless the wizard says to ask
Changes somethingThe person allows each call, or chooses “Allow for the rest of this run”. A wizard can let it run without asking
DeletesThe person allows it like a change. A wizard can never let it run without asking

The person’s mailbox

A wizard can ask for the person’s mailbox and read it: search emails, read them and keep attachments. It never writes. The person chooses how to connect:

WayWhat engenty wizards needs
Any mailbox over IMAPNothing
“Gmail” buttonThe Google client, with the Gmail API enabled and the scope gmail.readonly. On your computer without one, your engenty account
“Outlook” buttonThe Microsoft client, with the delegated permission Mail.Read

Connected systems

This section also holds “Connected systems”: MCP servers of your own, each with a name, its MCP URL and, if the server wants one, an authorization header. AI steps read from and write to these systems only where you allow the server on the step.

This is the other direction of AI apps: here engenty calls other servers, there your AI app calls engenty.

On this page