Skip to main content
Integrations let you connect external services to IllumiChat so your assistants can access data from the tools you already use. Each integration adds a set of tools that your assistants can use to search, read, and interact with that service during conversations. Integrations are powered by the Model Context Protocol (MCP), an open standard for connecting AI assistants to external tools and data sources.

​
How Integrations Work

1

Connect a service

Go to your workspace settings and authorize a service through OAuth.
2

Tools become available

Once connected, the tools from that service are automatically available to all assistants in your workspace.
3

Assistants use tools in chat

During a conversation, your assistant decides when to use an integration tool based on the user’s question. For example, if a user asks “What’s on my project tracker?”, the assistant can query Notion.
Integrations work best when combined with a custom assistant prompt. For example: “When users ask about project status, always check Notion first.”

​
Available Integrations

​
Notion

Connect your Notion workspace to let assistants search pages, read databases, and access your workspace content. What you can do:
  • Search across pages and databases
  • Read page content and database entries
  • Access workspace content you have shared with the integration
Setup:
1

Open integration settings

Go to your workspace Settings and select Integrations.
2

Connect Notion

Click Connect next to Notion.
3

Authorize access

In the Notion OAuth popup, sign in and authorize IllumiChat to access your Notion workspace.
4

Select pages and databases

Choose which pages and databases you want to share with IllumiChat.
Example use cases:
  • “Find my meeting notes from last week”
  • “What’s in my project tracker?”
  • “Summarize the Q4 planning document”

​
GitHub

Connect your GitHub account to let assistants search repositories, read issues and pull requests, and browse code. What you can do:
  • Search across repositories
  • Read issues and pull requests
  • Browse repository contents and code
Setup:
1

Open integration settings

Go to your workspace Settings and select Integrations.
2

Connect GitHub

Click Connect next to GitHub.
3

Install the GitHub App

Follow the prompts to install the IllumiChat GitHub App on your account or organization.
4

Select repositories

Choose which repositories to grant access to.
Example use cases:
  • “Show me open issues in my repo”
  • “Summarize the latest pull request”
  • “Are there any bug reports tagged as critical?”

​
Atlassian

Connect your Atlassian account to let assistants search Jira issues, read Confluence pages, and access project information. Example use cases:
  • “What are my open Jira tickets?”
  • “Summarize the latest Confluence page on our onboarding process”
  • “Show me high-priority bugs in the INGEST project”

​
HubSpot

Connect your HubSpot CRM to let assistants look up contacts, deals, and customer data. Example use cases:
  • “Look up the contact info for Acme Corp”
  • “What deals are in the pipeline this quarter?”
  • “Show me recent activity for this customer”

​
Managing Integrations

​
Viewing Connected Integrations

Go to Settings > Integrations to see all available integrations and their connection status.

​
Disconnecting an Integration

  1. Go to Settings > Integrations
  2. Find the integration you want to remove
  3. Click Disconnect
  4. Confirm the disconnection
Disconnecting immediately revokes IllumiChat’s access to that service.

​
Data Access and Privacy

Integrations only access data you have explicitly granted permission for. For Notion, this means only the pages and databases you selected during authorization. For GitHub, only the repositories you chose.
  • IllumiChat does not store data from connected services permanently. Data is fetched in real time during conversations.
  • OAuth tokens are encrypted and stored securely.
  • You can revoke access at any time by disconnecting the integration.

​
Access Control

Only workspace owners and admins can connect or disconnect integrations. Once connected, all assistants in the workspace can use the tools.

​
Troubleshooting

Verify you have granted access to the specific pages, databases, or repositories the assistant is trying to reach. Try disconnecting and reconnecting the integration.
Make sure you are logged in to the correct account on the external service. Disable browser extensions that might block popups. Try a different browser.
The assistant uses integrations when it determines they are relevant. Try asking a more specific question. Add instructions to your assistant’s system prompt, such as: “Use Notion to look up project information when asked.”