# Composio Integration

This guide will walk you through the steps of obtaining and configuring the MCP (Model Context Protocol) server URL from Composio, enabling your MaiAgent AI assistant to utilize Composio's MCP Server services.

## ✅ Prerequisites

* You have a Composio account.
* You want to integrate Composio's tools into your MaiAgent AI assistant.

## 🌐 Step 1: Access Composio MCP Directory

1. Open your web browser and directly visit the [**Composio MCP Tools Directory**](https://mcp.composio.dev/?_gl=1*1hz6rb*_ga*MTk3MzE0OTMzOC4xNzQ2MDk4NjI0*_ga_YKMWVQS9W0*czE3NDY5NTMzNzgkbzQkZzAkdDE3NDY5NTMzNzgkajYwJGwwJGgyMDc1NDkxNzYz*_ga_J9WD56TEBS*czE3NDY5NTMzNzgkbzQkZzAkdDE3NDY5NTMzNzgkajAkbDAkaDA.):
   * This page showcases all Composio tools and applications that can be integrated with your AI agent.

<figure><img src="https://3415477754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNBTi475lqozGpB7xObpE%2Fuploads%2Fgit-blob-4901b881dddf4a6c52011f664087db41852b86ea%2F%E6%88%AA%E5%9C%96%202025-05-11%20%E4%B8%8B%E5%8D%885.04.39.png?alt=media" alt="Composio MCP Directory Page"><figcaption><p>Composio MCP Directory displays numerous integrable applications and tools</p></figcaption></figure>

## 🔑 Step 2: Account Login

1. Find and click the **"Sign in"** button in the top right corner of the Composio MCP directory page.
2. Log in using your Composio account.
   * If you don't have a Composio account yet, you must complete the registration process first.

<figure><img src="https://3415477754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNBTi475lqozGpB7xObpE%2Fuploads%2Fgit-blob-20bfd09fa0a34519de6a87c2c35eb320862efa43%2F%E6%88%AA%E5%9C%96%202025-05-11%20%E4%B8%8B%E5%8D%885.06.04.png?alt=media" alt="Composio MCP Login Button Location"><figcaption><p>Click the "Sign in" button in the top right corner to log in</p></figcaption></figure>

3. After successful login, the page will update to a personalized MCP Dashboard, showing all tools and applications available to you.

<figure><img src="https://3415477754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNBTi475lqozGpB7xObpE%2Fuploads%2Fgit-blob-9f6fa93454bb1a9a2129a0735ca6bf531eac95ca%2F%E8%9E%A2%E5%B9%95%E6%93%B7%E5%8F%96%E7%95%AB%E9%9D%A2%202025-08-20%20110840.png?alt=media" alt="Composio MCP Login Button Location"><figcaption><p>Composio MCP Dashboard</p></figcaption></figure>

## 👆 Step 3: Choose Your Required Tools/Applications

1. Browse or search for the tools or applications you want your AI agent to use (such as Google Drive, Slack, Jira, GitHub, etc.) in the **Composio MCP Dashboard**.

For example, using Google Calendar:

<figure><img src="https://3415477754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNBTi475lqozGpB7xObpE%2Fuploads%2Fgit-blob-db31bbbed233743e9a53ee1e6ea8311215139bf5%2F%E8%9E%A2%E5%B9%95%E6%93%B7%E5%8F%96%E7%95%AB%E9%9D%A2%202025-08-20%20105214.png?alt=media" alt=""><figcaption></figcaption></figure>

## 🔐 Step 4: Create Server and Connect Account

1. After finding the tool, you need to authorize account linking before enabling the tool.

Click "<mark style="color:blue;">+Create Server</mark>"

<figure><img src="https://3415477754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNBTi475lqozGpB7xObpE%2Fuploads%2Fgit-blob-17afef14a4cdbef915b7d0752ecdded965ab68af%2Fimage%20(39).png?alt=media" alt=""><figcaption></figcaption></figure>

2. Name your Server, then click "<mark style="color:blue;">Next</mark>"

<figure><img src="https://3415477754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNBTi475lqozGpB7xObpE%2Fuploads%2Fgit-blob-58533aa5bbde26d4741e304d5071d8a6ce7fdff6%2Fimage%20(40).png?alt=media" alt=""><figcaption></figcaption></figure>

3. The system will display the service's authorization window. Please confirm granting access to Composio.

* For example, if it's a Google service, you'll need to select which Google account to authorize and confirm the scope of permissions.
* This step is necessary as Composio needs your authorization to perform actions on your behalf.

<figure><img src="https://3415477754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNBTi475lqozGpB7xObpE%2Fuploads%2Fgit-blob-18bb2558c8ba9468761e7c32f44cae1ce91d0326%2F%E6%88%AA%E5%9C%96%202025-05-11%20%E4%B8%8B%E5%8D%885.30.20.png?alt=media" alt="Composio MCP Login Button Location"><figcaption><p>Service authorization page - choose the authentication method provided by your service</p></figcaption></figure>

Click **"Connect"** and after authorization is complete, you'll be redirected back to the Composio platform

3. Select the tools you want to authorize and click "<mark style="color:blue;">Create Server</mark>" to establish the connection

* **Important Note**: Configure Actions can be selected based on the features users will actually use. If there are no specific requirements, selecting all is fine.

<figure><img src="https://3415477754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNBTi475lqozGpB7xObpE%2Fuploads%2Fgit-blob-332afd1b685406495b85180483010d73492f929b%2Fimage%20(42).png?alt=media" alt=""><figcaption></figcaption></figure>

## 🔗 Step 5: Copy MCP Server URL

1. After server setup is complete, the system will generate a dedicated **MCP server** for you.

{% hint style="info" %}
Please switch to HTTP Stream to support MaiAgent services
{% endhint %}

<figure><img src="https://3415477754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNBTi475lqozGpB7xObpE%2Fuploads%2Fgit-blob-50689ca3e7a2f60efce552113724c5658222c05b%2Fimage%20(43).png?alt=media" alt=""><figcaption></figcaption></figure>

2. Copy this HTTP URL and go to the MaiAgent page.

<figure><img src="https://3415477754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNBTi475lqozGpB7xObpE%2Fuploads%2Fgit-blob-c839670bd2fca42e6c84750dca206ce614b7595d%2F%E8%9E%A2%E5%B9%95%E6%93%B7%E5%8F%96%E7%95%AB%E9%9D%A2%202025-08-20%20110156.png?alt=media" alt=""><figcaption></figcaption></figure>

## 💻 Step 6: Set Up MCP Tool in MaiAgent

1. Open the MaiAgent tools page.
2. Add a new MCP tool.
3. Fill in the tool configuration:
   * **Basic Settings**: Complete the basic settings according to the user manual [Create Tool](https://docs.maiagent.ai/tools/setup), and select **MCP** as the tool type.
   * **Server URL**: Paste the Composio **MCP Server URL** you copied in Step 5 here.
   * **Parameters / Environment Variables / Allowed Tools**: These fields can remain empty as MaiAgent will automatically fetch them from the MCP Server when saving the tool settings.
4. Save the settings.

<figure><img src="https://3415477754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNBTi475lqozGpB7xObpE%2Fuploads%2Fgit-blob-9a1161943f94e16da13d25026f15d1c03e03bcb8%2Fimage%20(35).png?alt=media" alt=""><figcaption></figcaption></figure>

After completion, click "Refresh"

<figure><img src="https://3415477754-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FNBTi475lqozGpB7xObpE%2Fuploads%2Fgit-blob-a54e59189ed7a6703ed974f7bb4d661b2929807b%2Fimage%20(44).png?alt=media" alt=""><figcaption></figcaption></figure>

The system will automatically fetch the connected tools and display them in the "<mark style="color:blue;">Allowed Tools</mark>" list below.

## ⚠️ Important Notes

* **URL Privacy**: We emphasize again that the generated **MCP Server URL** is private and should not be disclosed.
* **Multiple Tools**: If you need to integrate multiple different applications (e.g., using both Google Drive and Slack simultaneously), you may need to repeat steps 3 to 5 in the **Composio MCP Directory** for each application to obtain their respective **MCP Server URLs**, and then configure different tools in MaiAgent to assign to your AI assistant.
* **Composio Documentation**: As Composio's interface or processes may be updated, it's recommended to always refer to the [latest official Composio documentation](https://docs.composio.dev/getting-started/welcome) for the most accurate information.