Connectors

Connectors are integrations with external services that your agents can use as tools. When an agent has a connector attached, it can read from and write to that service -- searching emails, creating GitHub issues, posting Slack messages, and more.

Available connectors

Lantern ships with built-in connectors for:

• Gmail -- read, search, draft, and send emails
• Google Calendar -- read and create events, check availability
• Slack -- read channels, post messages, manage threads
• GitHub -- read repos, create issues, manage PRs, search code
• Linear -- read and create issues, manage projects
• Notion -- read and update pages, search databases
• Google Drive -- read and search documents
• Web Search -- search the web via configurable providers
• Web Scrape -- read and extract content from URLs

Setting up a connector

OAuth-based connectors

Most connectors (Gmail, Google Calendar, Slack, GitHub, Notion) use OAuth for authentication. The setup flow is:

1. Navigate to Settings > Connectors in the dashboard
2. Click the connector you want to enable
3. Click Connect -- you will be redirected to the service's OAuth consent screen
4. Authorize access and you will be redirected back to Lantern
5. The connector is now available and can be attached to any agent

[Screenshot: Connectors settings page with OAuth flow]

API key-based connectors

Some connectors (Web Search, custom APIs) use API keys instead of OAuth. For these:

1. Navigate to Settings > Connectors
2. Click the connector and select Manual credentials
3. Enter your API key or credentials
4. Click Save -- credentials are encrypted at rest using your tenant's encryption key

Per-agent connector assignment

Connectors are enabled at the account level but assigned per agent. This means:

• You connect your Gmail account once in Settings
• For each agent, you choose which connectors it can access
• An agent can only use connectors explicitly assigned to it

To assign connectors to an agent:

1. Open the agent's detail page in the dashboard
2. Go to the Configuration tab
3. In the Connectors section, toggle the connectors this agent should have access to
4. Click Save

[Screenshot: Agent configuration with connector toggles]

How agents use connectors

When an agent runs, its assigned connectors are injected as tools that the LLM can call. For example, an agent with the Gmail connector can:

// The agent's LLM can call these tools automatically:
ctx.tools.gmail.search({ query: "from:boss@company.com subject:urgent" })
ctx.tools.gmail.draft({ to: "team@company.com", subject: "Summary", body: "..." })
ctx.tools.github.createIssue({ repo: "org/repo", title: "Bug: ...", body: "..." })

The LLM decides when to use each tool based on the agent's system prompt and the user's input. You do not need to write code to invoke connectors -- just assign them and the LLM handles the rest.

Connector permissions

Each connector requests the minimum set of permissions (OAuth scopes) needed for its functionality. You can review the exact permissions on the connector's detail page in Settings.

• Gmail -- read and send email (not delete)
• GitHub -- read repos, issues, PRs; create issues and comments
• Slack -- read channels, post messages, manage threads