Agent integrations

Agent integrations give the agent access to context from other tools that your team uses. Once connected, the agent can search Slack threads, read Notion pages, look up Linear issues, and pull context from other apps to inform its responses and content updates.

​

Connection scope

Integrations connect in one of two ways:

• Shared integrations connect once for your entire organization. Anyone on the team can prompt the agent to use them. Slack, Notion, Linear, Jira, Confluence, Salesforce, Intercom, HubSpot, and Plain all connect this way.
• Personal integrations connect per user. Each teammate authorizes their own account, and the agent can only use a personal integration on behalf of the user who connected it. Google Calendar and Google Drive are personal.

Personal integrations keep user-specific data, like calendar events, scoped to the user who connected the integration instead of shared across the organization.

​

Connect an integration

Admins and editors can connect shared integrations on behalf of the organization.

1. Go to the Agent integrations page in your dashboard.
2. Find the integration you want to connect.
3. Click Connect.
4. Follow the OAuth prompts to authorize Mintlify to access your account.

Some integrations open an additional configuration step before the connection completes. Jira, Confluence, and Salesforce ask for your workspace URL or subdomain before the OAuth flow begins, and API-key providers like Plain prompt you to paste an API key.

​

Supported integrations

​

How the agent uses integrations

The agent uses connected integrations as tools. When you ask the agent a question or give it a task, it can search and retrieve content from your connected apps to build context. For example:

• “Summarize the Slack thread about the v2 API migration and write it up for the knowledge base.”
• “Check the Linear ticket for this feature and document the behavior.”
• “What did the team decide about rate limiting? Check Slack.”

The agent only accesses integration data when it’s relevant to the request. It does not proactively read from connected apps.

​

Permissions and access

Each integration requests the OAuth scopes or API-key permissions it needs to search and retrieve content from the connected app. Mintlify requests read-only scopes wherever the provider offers them. Review the exact scopes during the OAuth consent screen before authorizing the connection. The consent screen lists every permission the agent receives, and you can revoke the connection at any time from the dashboard or from the connected app’s own integrations settings. If your organization restricts which apps users can authorize, ask the relevant admin (such as your Slack or Google Workspace admin) to allow the Mintlify integration before connecting.

​

Troubleshoot a failed connection

If an integration stops working or shows an error in the dashboard, the underlying OAuth token has usually expired, been revoked in the connected app, or had its required scopes changed. To restore access:

1. Go to the Agent integrations page in your dashboard.
2. Find the affected integration and click Configure.
3. Click Disconnect.
4. Click Connect.
5. Complete the OAuth flow.

For API-key providers like Plain, generate a new API key in the source app and paste it into the integration’s configuration. If the agent still can’t access data after reconnecting, confirm that the authorizing user has permission to view the relevant content in the source app.

​

Disconnect an integration

1. Go to the Agent integrations page in your dashboard.
2. Find the connected integration you want to disconnect.
3. Click Configure.
4. Click Disconnect.

Disconnecting a shared integration removes it for everyone in your organization, and the agent immediately loses access to that tool. Disconnecting a personal integration only removes your own connection. Other teammates who have connected the same integration keep their access, and the agent can still use the integration on their behalf.