> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-en/maigpt/connectors.md).

# Connectors

Connectors let MaiGPT access your third-party tools such as Notion, Slack, Google Drive, and GitHub. Once connected, you can query and interact with data in these tools directly from the conversation.

***

## Available Tools

| Tool             | What You Can Do After Connecting                |
| ---------------- | ----------------------------------------------- |
| **Notion**       | Search pages, query databases, create new pages |
| **Slack**        | Search messages, view channel content           |
| **Google Drive** | Search and read documents                       |
| **GitHub**       | View repositories, issues, pull requests        |

{% hint style="info" %}
Available connectors are configured by your company administrator. If the tool you need is not listed, contact your admin.
{% endhint %}

***

## How to Connect

### 1. Open Connector Settings

Click the tools icon in the chat interface to find the connectors section.

### 2. Authorize Your Account

Select the tool you want to connect, click "Connect," and you'll be redirected to that tool's authorization page. Follow the prompts to complete authorization.

### 3. Start Using

Once connected, ask questions directly in the conversation:

> "Search Notion for pages about the Q1 plan"
>
> "Look up the quote document in Google Drive"

***

## Managing Connected Tools

You can do the following at any time in the connector settings:

* **View** — Currently connected tools
* **Disconnect** — Remove a tool's connection
* **Reauthorize** — Reauthorize if a connection has expired

***

## Notion

After connecting Notion, you can search Notion pages, query databases, and even create new pages directly in MaiGPT.

### Connection Steps

1. Open connector settings and find Notion
2. Click "Connect" to go to the Notion authorization page
3. Select the pages or workspace you want to grant MaiGPT access to
4. Click "Allow" to complete authorization

### What You Can Do

Once connected, say the following in the conversation:

| You Say                                                  | MaiGPT Does                              |
| -------------------------------------------------------- | ---------------------------------------- |
| "Search Notion for pages about product specifications"   | Searches and lists relevant pages        |
| "Check the Notion project database for incomplete tasks" | Queries the database and filters results |
| "Create a new page in Notion titled Meeting Minutes"     | Creates a new page                       |
| "Save this summary to Notion"                            | Writes content to Notion                 |

### Important Notes

{% hint style="warning" %}
**Authorization Scope**

When authorizing Notion, you can choose which pages to share with MaiGPT. Only pages you've authorized can be searched. If a page can't be found, verify that you've authorized access to it.
{% endhint %}

***

## Slack

After connecting Slack, you can search Slack messages and channel content in MaiGPT to quickly find previous discussions.

### Connection Steps

1. Open connector settings and find Slack
2. Click "Connect" to go to the Slack authorization page
3. Confirm the authorization scope and click "Allow"

### What You Can Do

| You Say                                               | MaiGPT Does                           |
| ----------------------------------------------------- | ------------------------------------- |
| "Search Slack for discussions about server migration" | Searches relevant messages            |
| "Check what's been discussed recently in #general"    | Summarizes channel content            |
| "Find the link John mentioned last week"              | Searches a specific person's messages |

***

## Google Drive

After connecting Google Drive, you can search and read your Google Drive documents in MaiGPT.

### Connection Steps

1. Open connector settings and find Google Drive
2. Click "Connect" to go to the Google authorization page
3. Select your Google account and allow access

### What You Can Do

| You Say                                          | MaiGPT Does                               |
| ------------------------------------------------ | ----------------------------------------- |
| "Search Google Drive for the quote document"     | Searches and lists relevant files         |
| "Open the last meeting minutes"                  | Finds and reads the document content      |
| "Summarize that market analysis report in Drive" | Reads the document and produces a summary |

### Important Notes <a href="#google-drive-notes" id="google-drive-notes"></a>

{% hint style="warning" %}
**Only Google Native Formats Are Supported**

Currently, only Google native formats such as Google Docs, Sheets, and Slides can be read. Office formats like `.pptx`, `.docx`, and `.xlsx` **cannot be read directly**. Please convert them to Google format in Google Drive before referencing them.
{% endhint %}

{% hint style="warning" %}
**Shared Drive and External Sharing Limitations**

Files stored in a Shared Drive or existing as shortcuts may still fail to be read even after authorization. Ensure the authorized account has access permissions to the Shared Drive, and use the original file link instead of shortcuts.
{% endhint %}

***

## GitHub

After connecting GitHub, you can query repositories, issues, pull requests, and other development-related information in MaiGPT.

### Connection Steps

1. Open connector settings and find GitHub
2. Click "Connect" to go to the GitHub authorization page
3. Select the repositories to authorize and confirm

### What You Can Do

| You Say                                              | MaiGPT Does                 |
| ---------------------------------------------------- | --------------------------- |
| "Check what open issues main-repo has recently"      | Lists issues                |
| "Show me a summary of changes in PR #123"            | Reads the PR and summarizes |
| "Search the repo for code related to authentication" | Searches code               |

***

## Next Steps

* [Manage access permissions](/maiagent-user-guide/maiagent-user-guide-en/maigpt/access.md)
* [Back to MaiGPT Overview](/maiagent-user-guide/maiagent-user-guide-en/maigpt/maigpt.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-en/maigpt/connectors.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.