# How to integrate Recallai MCP with OpenAI Agents SDK

```json
{
  "title": "How to integrate Recallai MCP with OpenAI Agents SDK",
  "toolkit": "Recallai",
  "toolkit_slug": "recallai",
  "framework": "OpenAI Agents SDK",
  "framework_slug": "open-ai-agents-sdk",
  "url": "https://composio.dev/toolkits/recallai/framework/open-ai-agents-sdk",
  "markdown_url": "https://composio.dev/toolkits/recallai/framework/open-ai-agents-sdk.md",
  "updated_at": "2026-05-12T10:23:30.606Z"
}
```

## Introduction

This guide walks you through connecting Recallai to the OpenAI Agents SDK using the Composio tool router. By the end, you'll have a working Recallai agent that can start recording your zoom meeting now, list all bots active in meetings, retrieve chat messages from today's calls through natural language commands.
This guide will help you understand how to give your OpenAI Agents SDK agent real control over a Recallai account through Composio's Recallai MCP server.
Before we dive in, let's take a quick look at the key ideas and tools involved.

## Also integrate Recallai with

- [Claude Agent SDK](https://composio.dev/toolkits/recallai/framework/claude-agents-sdk)
- [Claude Code](https://composio.dev/toolkits/recallai/framework/claude-code)
- [Claude Cowork](https://composio.dev/toolkits/recallai/framework/claude-cowork)
- [Codex](https://composio.dev/toolkits/recallai/framework/codex)
- [OpenClaw](https://composio.dev/toolkits/recallai/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/recallai/framework/hermes-agent)
- [CLI](https://composio.dev/toolkits/recallai/framework/cli)
- [Google ADK](https://composio.dev/toolkits/recallai/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/recallai/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/recallai/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/recallai/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/recallai/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/recallai/framework/crew-ai)

## TL;DR

Here's what you'll learn:
- Get and set up your OpenAI and Composio API keys
- Install the necessary dependencies
- Initialize Composio and create a Tool Router session for Recallai
- Configure an AI agent that can use Recallai as a tool
- Run a live chat session where you can ask the agent to perform Recallai operations

## What is OpenAI Agents SDK?

The OpenAI Agents SDK is a lightweight framework for building AI agents that can use tools and maintain conversation state. It provides a simple interface for creating agents with hosted MCP tool support.
Key features include:
- Hosted MCP Tools: Connect to external services through hosted MCP endpoints
- SQLite Sessions: Persist conversation history across interactions
- Simple API: Clean interface with Agent, Runner, and tool configuration
- Streaming Support: Real-time response streaming for interactive applications

## What is the Recallai MCP server, and what's possible with it?

The Recallai MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Recallai account. It provides structured and secure access to your meeting bots and conversation data, so your agent can create bots, manage recordings, retrieve chat messages, and orchestrate meeting participation on your behalf.
- Automated bot creation and management: Quickly spin up new meeting bots, retrieve details, and remove bots as needed for your meetings.
- Meeting recording control: Let your agent start or stop recordings during live calls, ensuring you capture the most important moments hands-free.
- Chat message retrieval: Effortlessly access and analyze chat messages exchanged during meetings, enabling summaries or follow-up actions.
- Bot participation orchestration: Seamlessly remove bots from calls when their job is done, keeping your meetings efficient and secure.
- Comprehensive bot listing and oversight: View and manage all active bots connected to your Recallai account for smooth operations and tracking.

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `RECALLAI_CREATE_BOT` | Create bot | Create a new bot to join and record a meeting. This action creates a meeting bot that can join Zoom, Google Meet, Microsoft Teams, and other supported platforms to record audio, video, and capture transcriptions. For production use, schedule bots at least 10 minutes in advance using the join_at parameter to ensure the bot joins on time. |
| `RECALLAI_CREATE_CALENDAR` | Create Calendar Integration | Tool to create a new calendar integration with Google Calendar or Microsoft Outlook. Use when you need to connect a calendar platform to enable automatic bot scheduling for meetings. |
| `RECALLAI_CREATE_CALENDAR_AUTHENTICATE` | Create Calendar Authentication Token | Tool to generate an authentication token for calendar APIs, scoped to the user. Use when you need to authenticate calendar operations for a specific user. Each token has an expiry of 1 day from time of creation. |
| `RECALLAI_CREATE_GOOGLE_LOGIN` | Create Google Login | Tool to create a new Google Login credential within a login group. Use when you need to add a new Google account that bots can use to authenticate and join Google Meet meetings. |
| `RECALLAI_CREATE_GOOGLE_LOGIN_GROUP` | Create Google Login Group | Tool to create a new Google Login Group for managing bot authentication. Use when you need to create a group of Google login credentials that bots can use to join Google Meet meetings. |
| `RECALLAI_CREATE_MEETING_DIRECT_CONNECT` | Create Meeting Direct Connect | Tool to create a Meeting Direct Connect for Google Meet or Zoom. Use when you need to connect directly to a meeting platform's media stream via Google Meet Media API or Zoom RTMS. Either google_meet_media_api or zoom_rtms credentials must be provided, but not both. |
| `RECALLAI_CREATE_SDK_UPLOAD` | Create SDK Upload | Create a new Desktop SDK upload. Use this to generate an upload token that can be used with the Recall.ai Desktop SDK to upload recordings directly from desktop applications. |
| `RECALLAI_CREATE_ZOOM_OAUTH_APP` | Create Zoom OAuth App | Tool to create a new Zoom OAuth App integration with Recall.ai. Use when you need to configure Zoom OAuth credentials to enable bots to join Zoom meetings. |
| `RECALLAI_DELETE_BOT` | Delete bot | Delete a scheduled bot by ID. This can only be used for scheduled bots that have not yet joined a call. If the bot is already in a call or about to join (less than 10 minutes before join time), use the REMOVE_BOT_FROM_CALL action instead. |
| `RECALLAI_DELETE_BOT_MEDIA` | Delete Bot Media | Deletes bot media stored by Recall AI. This operation is irreversible and permanently removes all media files associated with the specified bot. |
| `RECALLAI_DELETE_CALENDAR` | Delete calendar | Delete a calendar by ID. This will disconnect the calendar from Recall.ai. Use this when you need to remove a calendar integration. |
| `RECALLAI_DESTROY_CALENDAR_USER` | Delete Calendar User | Delete calendar user and disconnect any connected calendars. This is a destructive operation that permanently removes the calendar user account and disconnects all associated calendar platform connections (Google, Microsoft, etc.). |
| `RECALLAI_DESTROY_GOOGLE_LOGIN` | Destroy Google Login | Tool to delete an existing Google Login by ID. Use when you need to remove a Google Login credential that is no longer needed. |
| `RECALLAI_DESTROY_GOOGLE_LOGIN_GROUP` | Destroy Google Login Group | Tool to delete an existing Google Login Group by ID. Use when you need to remove a Google Login Group that is no longer needed. |
| `RECALLAI_DESTROY_ZOOM_O_AUTH_APP` | Destroy Zoom OAuth App | Tool to delete a Zoom OAuth App by ID. Use when you need to remove a Zoom OAuth application that is no longer needed. |
| `RECALLAI_DISCONNECT_CALENDAR_USER` | Disconnect Calendar User | Tool to disconnect a calendar platform (Google or Microsoft) from the user's Recall.ai account. Use when you need to remove calendar integration for a specific platform. |
| `RECALLAI_LIST_AUDIO_MIXED` | List audio mixed | List audio mixed artifacts from Recall.ai recordings. Returns a paginated list of mixed audio files with their processing status and download URLs. Use filters to narrow results by date range, recording ID, or processing status. Rate limit: 60 requests per minute per workspace. |
| `RECALLAI_LIST_AUDIO_SEPARATE` | List Audio Separate | List audio separation artifacts from recordings. Returns a paginated list of audio separation processing jobs with their status and download URLs for completed separations. Use this to retrieve participant-separated audio files from recorded meetings. |
| `RECALLAI_LIST_BOTS` | List bots | List all bots in your Recall.ai workspace. Returns a paginated list of bots with their current status, meeting details, and configuration. Note: The meeting_url field is returned as a parsed object rather than a string. |
| `RECALLAI_LIST_BOT_SCREENSHOTS` | List Bot Screenshots | List all screenshots captured by a bot during a meeting. Returns screenshots with their timestamp and download URL. Use filters to narrow results by recording time. |
| `RECALLAI_LIST_CALENDAR_EVENTS` | List Calendar Events | Get a list of calendar events from connected calendars. Returns paginated calendar events with details about meeting URLs, platforms, and associated bots. Use filters like start_time__gte and start_time__lte to retrieve events within specific time ranges. |
| `RECALLAI_LIST_CALENDAR_MEETINGS` | List calendar meetings | List all calendar meetings for the authenticated calendar user. Filter by iCalendar UID or time range. Use this to retrieve upcoming meetings, find specific events, or sync calendar data with bots. |
| `RECALLAI_LIST_CALENDARS` | List calendars | Tool to retrieve a list of calendars integrated with Recall.ai. Use when you need to view all connected calendar accounts, check connection status, or filter calendars by platform (Google Calendar, Microsoft Outlook), email, or creation date. Supports pagination for large result sets. |
| `RECALLAI_LIST_CALENDAR_USERS` | List calendar users | List all calendar users created for the account. Calendar users are used to automatically join and record meetings from integrated calendar providers. Use this to view all configured calendar users and their connection status. |
| `RECALLAI_LIST_CHAT_MESSAGES` | List chat messages | Get list of chat messages read by the bot in the meeting(excluding messages sent by the bot itself). |
| `RECALLAI_LIST_GOOGLE_LOGIN_GROUPS` | List Google Login Groups | Tool to retrieve a list of all Google Login Groups in your Recall.ai workspace. Use when you need to view available Google login configurations for bot authentication. Supports pagination and filtering by name. |
| `RECALLAI_LIST_GOOGLE_LOGINS` | List Google Logins | Tool to retrieve a list of all Google Logins in your Recall.ai workspace. Use when you need to view individual Google login credentials. Supports pagination and filtering by email, group ID, active status, and workspace domain. |
| `RECALLAI_LIST_MEETING_DIRECT_CONNECT` | List Meeting Direct Connects | List all Meeting Direct Connect instances in your Recall.ai workspace. Returns a list of Meeting Direct Connect objects with their status, recordings, and configuration. Use this to monitor active direct connections and access their recordings. |
| `RECALLAI_LIST_MEETING_METADATA` | List Meeting Metadata | List meeting metadata from Recall.ai recordings. Returns metadata extracted from meeting recordings including titles, participant info, and processing status. Use filtering to narrow results by date range, recording ID, or processing status. Results are paginated. |
| `RECALLAI_LIST_PARTICIPANT_EVENTS` | List participant events | List participant events artifacts from recorded meetings. Returns download URLs for participant events, speaker timelines, and participant lists. Use status_code filter to find completed artifacts ready for download. |
| `RECALLAI_LIST_REALTIME_ENDPOINT` | List Realtime Endpoints | Tool to list realtime endpoints from Recall.ai. Use when you need to retrieve realtime endpoints filtered by creation date, recording, status, or type. Returns paginated results. The base rate limit for this endpoint is 60 requests per minute per workspace. |
| `RECALLAI_LIST_RECORDING` | List Recordings | Tool to list recordings from Recall.ai. Use when you need to retrieve recordings filtered by bot, creation date, status, or desktop SDK upload. Returns paginated results. |
| `RECALLAI_LIST_SDK_UPLOADS` | List Desktop SDK Uploads | Tool to get a paginated list of all Desktop SDK uploads in your Recall.ai workspace. Use when you need to retrieve upload history, monitor upload status, or access upload tokens and recording configurations. |
| `RECALLAI_LIST_SLACK_TEAMS` | List Slack Teams | Tool to list all Slack team integrations. Use when you need to retrieve configured Slack teams for huddle bot functionality. Returns all Slack workspaces where the bot can join huddles. |
| `RECALLAI_LIST_TRANSCRIPT` | List transcript | Tool to list transcripts from Recall.ai recordings. Returns a paginated list of transcripts with their status, content, and metadata. Use when you need to retrieve or filter transcripts by recording, status, or creation time. |
| `RECALLAI_LIST_VIDEO_MIXED` | List Video Mixed Artifacts | List video mixed artifacts from recorded meetings. Video mixed artifacts combine all video sources (participants, screen shares, etc.) into a single MP4 file. Use when you need to retrieve processed meeting recordings with combined video output. |
| `RECALLAI_LIST_VIDEO_SEPARATE` | List video separate | List video separate artifacts from Recall.ai recordings. Returns a paginated list of artifacts containing individual participant video files separated from recordings. Filter by creation date, recording ID, or processing status. Use cursor for pagination. |
| `RECALLAI_LIST_ZOOM_MEETINGS_TO_CREDENTIALS` | List zoom meetings to credentials | Tool to retrieve mappings from Zoom Meeting IDs to Zoom OAuth Credentials. Use when debugging bots that don't automatically record due to missing credentials or when inspecting which credential Recall uses for automatically fetching join tokens for a meeting. Supports filtering by credential, meeting ID, or sync time. |
| `RECALLAI_LIST_ZOOM_OAUTH_APP_LOGS` | List Zoom OAuth App Logs | Tool to retrieve Zoom OAuth app logs from Recall.ai. Use when you need to view warnings or errors related to Zoom OAuth apps for debugging purposes. Supports filtering by OAuth app, creation date, and pagination. Rate limit: 60 requests per minute per workspace. |
| `RECALLAI_LIST_ZOOM_OAUTH_APPS` | List Zoom OAuth Apps | Tool to retrieve a list of Zoom OAuth apps configured in Recall.ai. Use when you need to view all registered Zoom OAuth applications, check their configuration, or filter by client ID, creation date, or webhook validation. Supports pagination for large result sets. |
| `RECALLAI_LIST_ZOOM_OAUTH_CREDENTIAL_LOGS` | List Zoom OAuth Credential Logs | Tool to retrieve all Zoom OAuth Credential logs from Recall.ai. Use when debugging OAuth credential issues or investigating warnings and errors related to Zoom OAuth credentials. Helpful for troubleshooting authentication problems with Zoom bots. |
| `RECALLAI_LIST_ZOOM_O_AUTH_CREDENTIALS` | List Zoom OAuth Credentials | Tool to retrieve a list of all Zoom OAuth credentials in your Recall.ai workspace. Use when you need to view Zoom authentication credentials, check their health status, or filter by account ID, user ID, sync status, or OAuth app. Supports pagination for large result sets. |
| `RECALLAI_REMOVE_BOT_FROM_CALL` | Remove bot from call | Removes the bot from the meeting call. This action is irreversible and will immediately disconnect the bot. Use this when you need to manually end a bot's participation in a meeting before it would automatically leave. The bot must be in a state where it's joining or in a call (not already completed or failed). |
| `RECALLAI_RETRIEVE_BILLING_USAGE` | Retrieve Billing Usage | Retrieve bot usage statistics for billing purposes. Returns the total amount of bot usage time in seconds for a specified date range. Use this to monitor usage, track billing metrics, or analyze bot activity over time. |
| `RECALLAI_RETRIEVE_BOT` | Retrieve bot | Retrieve detailed information about a specific bot instance by its ID. Returns comprehensive bot data including meeting details, recording configuration, status history, recordings, and automatic leave settings. Use this to check bot status, access recordings, or monitor bot lifecycle events. |
| `RECALLAI_RETRIEVE_CALENDARS` | Retrieve calendars | Retrieve detailed information about a specific calendar by its UUID. Returns the calendar configuration including OAuth credentials, platform details, status, and webhook settings. |
| `RECALLAI_RETRIEVE_GOOGLE_LOGIN_GROUP` | Retrieve Google Login Group | Tool to retrieve an existing Google Login Group by its ID. Use when you need to fetch details about a specific Google login group, including its login credentials, login mode, and associated metadata. |
| `RECALLAI_RETRIEVE_MEETING_DIRECT_CONNECT` | Retrieve Meeting Direct Connect | Tool to retrieve detailed information about a Meeting Direct Connect instance by its ID. Use when you need to check the status, configuration, or recordings of a specific Meeting Direct Connect instance. |
| `RECALLAI_RETRIEVE_RECORDING` | Retrieve recording | Tool to retrieve detailed information about a specific recording by its UUID. Returns comprehensive recording data including creation timestamps, status, media file shortcuts, and associated bot or desktop SDK upload references. Use when you need to access recording details, download links, or check recording status. |
| `RECALLAI_RETRIEVE_SDK_UPLOAD` | Retrieve sdk upload | Retrieve detailed information about a Desktop SDK upload instance by its ID. Returns comprehensive upload data including status, recording configuration, upload token, and metadata. Use this to check upload status or access recording details. |
| `RECALLAI_RETRIEVE_VIDEO_MIXED` | Retrieve Video Mixed | Retrieve a video mixed artifact by its ID. Returns details about the mixed video including download URL, format, status, and associated recording information. Use this to access processed mixed video files from recordings. |
| `RECALLAI_RETRIEVE_ZOOM_OAUTH_APP` | Retrieve Zoom OAuth App | Retrieve detailed information about a specific Zoom OAuth app by its ID. Returns the OAuth app configuration including client credentials, app type (user-level or account-level), webhook settings, and creation timestamp. Use this to verify OAuth app configuration or retrieve credentials for integration setup. |
| `RECALLAI_START_RECORDING` | Start recording | Instructs the bot to start recording the meeting. This will restart the current recording if one is already in progress. |
| `RECALLAI_STOP_RECORDING` | Stop recording | Stops the current recording for the specified bot. This creates a new recording entry in the bot's recordings field. Important: The bot must be actively recording for this action to succeed. If the bot is not in a call or not currently recording, the API will return a 400 error. Use the RECALLAI_RETRIEVE_BOT action to check the bot's status before attempting to stop recording. Note: For pausing and resuming a single continuous recording, use the pause/resume recording endpoints instead. Stop recording will create separate recording entries. |
| `RECALLAI_UPDATE_BOT` | Update Bot | Tool to partially update a scheduled bot. Use when you need to modify bot settings like bot_name, metadata, or configuration options for a scheduled bot that has not yet completed. Only provide fields you want to update. |
| `RECALLAI_UPDATE_CALENDAR` | Update Calendar | Update an existing calendar integration in Recall.ai. Use this to modify calendar metadata, OAuth credentials, webhook URLs, or platform settings. Only include fields you want to update; omitted fields remain unchanged. |
| `RECALLAI_UPDATE_CALENDAR_USER` | Update Calendar User | Update recording preferences and calendar connections for a calendar user. Use this to configure which meetings should be automatically recorded based on meeting type (internal/external, recurring, host status) and to manage calendar platform connections (Google, Microsoft). |
| `RECALLAI_UPDATE_GOOGLE_LOGIN` | Update Google Login | Tool to update an existing Google Login credential. Use when you need to modify authentication details like email, certificates, private keys, or SSO workspace domain for an existing Google login that bots use to join Google Meet meetings. |
| `RECALLAI_UPDATE_GOOGLE_LOGIN_GROUP` | Update Google Login Group | Tool to update an existing Google Login Group in Recall.ai. Use when you need to modify the name, login mode, or login credentials for a Google login group that bots use to authenticate with Google Meet. |
| `RECALLAI_UPDATE_GOOGLE_LOGIN_GROUPS` | Partial Update Google Login Group | Tool to partially update an existing Google Login Group in Recall.ai. Use when you need to modify the name or login mode of a Google login group without replacing all fields. This performs a PATCH operation that only updates the fields you provide. |
| `RECALLAI_UPDATE_RECORDING` | Update Recording | Tool to update a recording's metadata. Use when you need to update custom metadata fields on an existing recording without modifying other recording properties. |
| `RECALLAI_UPDATE_VIDEO_MIXED` | Update Video Mixed | Tool to partially update a video mixed artifact by ID. Use when you need to update metadata or other properties of an existing video mixed artifact without replacing the entire resource. This is commonly used to attach custom metadata to video recordings. |
| `RECALLAI_UPDATE_ZOOM_O_AUTH_APP` | Update Zoom OAuth App | Tool to update an existing Zoom OAuth App's credentials. Use when you need to update the client secret or webhook secret for a Zoom OAuth app without changing other properties. |

## Supported Triggers

None listed.

## Creating MCP Server - Stand-alone vs Composio SDK

The Recallai MCP server is an implementation of the Model Context Protocol that connects your AI agent to Recallai. It provides structured and secure access so your agent can perform Recallai operations on your behalf through a secure, permission-based interface.
With Composio's managed implementation, you don't have to create your own developer app. For production, if you're building an end product, we recommend using your own credentials. The managed server helps you prototype fast and go from 0-1 faster.

## Step-by-step Guide

### 1. Prerequisites

Before starting, make sure you have:
- Composio API Key and OpenAI API Key
- Primary know-how of OpenAI Agents SDK
- A live Recallai project
- Some knowledge of Python or Typescript

### 1. Getting API Keys for OpenAI and Composio

OpenAI API Key
- Go to the [OpenAI dashboard](https://platform.openai.com/settings/organization/api-keys) and create an API key. You'll need credits to use the models, or you can connect to another model provider.
- Keep the API key safe.
Composio API Key
- Log in to the [Composio dashboard](https://dashboard.composio.dev?utm_source=toolkits&utm_medium=framework_docs).
- Go to Settings and copy your API key.

### 2. Install dependencies

Install the Composio SDK and the OpenAI Agents SDK.
```python
pip install composio_openai_agents openai-agents python-dotenv
```

```typescript
npm install @composio/openai-agents @openai/agents dotenv
```

### 3. Set up environment variables

Create a .env file and add your OpenAI and Composio API keys.
```bash
OPENAI_API_KEY=sk-...your-api-key
COMPOSIO_API_KEY=your-api-key
USER_ID=composio_user@gmail.com
```

### 4. Import dependencies

What's happening:
- You're importing all necessary libraries.
- The Composio and OpenAIAgentsProvider classes are imported to connect your OpenAI agent to Composio tools like Recallai.
```python
import asyncio
import os
from dotenv import load_dotenv

from composio import Composio
from composio_openai_agents import OpenAIAgentsProvider
from agents import Agent, Runner, HostedMCPTool, SQLiteSession
```

```typescript
import 'dotenv/config';
import { Composio } from '@composio/core';
import { OpenAIAgentsProvider } from '@composio/openai-agents';
import { Agent, hostedMcpTool, run, OpenAIConversationsSession } from '@openai/agents';
import * as readline from 'readline';
```

### 5. Set up the Composio instance

No description provided.
```python
load_dotenv()

api_key = os.getenv("COMPOSIO_API_KEY")
user_id = os.getenv("USER_ID")

if not api_key:
    raise RuntimeError("COMPOSIO_API_KEY is not set. Create a .env file with COMPOSIO_API_KEY=your_key")

# Initialize Composio
composio = Composio(api_key=api_key, provider=OpenAIAgentsProvider())
```

```typescript
dotenv.config();

const composioApiKey = process.env.COMPOSIO_API_KEY;
const userId = process.env.USER_ID;

if (!composioApiKey) {
  throw new Error('COMPOSIO_API_KEY is not set. Create a .env file with COMPOSIO_API_KEY=your_key');
}
if (!userId) {
  throw new Error('USER_ID is not set');
}

// Initialize Composio
const composio = new Composio({
  apiKey: composioApiKey,
  provider: new OpenAIAgentsProvider(),
});
```

### 6. Create a Tool Router session

What is happening:
- You give the Tool Router the user id and the toolkits you want available. Here, it is only recallai.
- The router checks the user's Recallai connection and prepares the MCP endpoint.
- The returned session.mcp.url is the MCP URL that your agent will use to access Recallai.
- This approach keeps things lightweight and lets the agent request Recallai tools only when needed during the conversation.
```python
# Create a Recallai Tool Router session
session = composio.create(
    user_id=user_id,
    toolkits=["recallai"]
)

mcp_url = session.mcp.url
```

```typescript
// Create Tool Router session for Recallai
const session = await composio.create(userId as string, {
  toolkits: ['recallai'],
});
const mcpUrl = session.mcp.url;
```

### 7. Configure the agent

No description provided.
```python
# Configure agent with MCP tool
agent = Agent(
    name="Assistant",
    model="gpt-5",
    instructions=(
        "You are a helpful assistant that can access Recallai. "
        "Help users perform Recallai operations through natural language."
    ),
    tools=[
        HostedMCPTool(
            tool_config={
                "type": "mcp",
                "server_label": "tool_router",
                "server_url": mcp_url,
                "headers": {"x-api-key": api_key},
                "require_approval": "never",
            }
        )
    ],
)
```

```typescript
// Configure agent with MCP tool
const agent = new Agent({
  name: 'Assistant',
  model: 'gpt-5',
  instructions:
    'You are a helpful assistant that can access Recallai. Help users perform Recallai operations through natural language.',
  tools: [
    hostedMcpTool({
      serverLabel: 'tool_router',
      serverUrl: mcpUrl,
      headers: { 'x-api-key': composioApiKey },
      requireApproval: 'never',
    }),
  ],
});
```

### 8. Start chat loop and handle conversation

No description provided.
```python
print("\nComposio Tool Router session created.")

chat_session = SQLiteSession("conversation_openai_toolrouter")

print("\nChat started. Type your requests below.")
print("Commands: 'exit', 'quit', or 'q' to end\n")

async def main():
    try:
        result = await Runner.run(
            agent,
            "What can you help me with?",
            session=chat_session
        )
        print(f"Assistant: {result.final_output}\n")
    except Exception as e:
        print(f"Error: {e}\n")

    while True:
        user_input = input("You: ").strip()
        if user_input.lower() in {"exit", "quit", "q"}:
            print("Goodbye!")
            break

        result = await Runner.run(
            agent,
            user_input,
            session=chat_session
        )
        print(f"Assistant: {result.final_output}\n")

asyncio.run(main())
```

```typescript
// Keep conversation state across turns
const conversationSession = new OpenAIConversationsSession();

// Simple CLI
const rl = readline.createInterface({
  input: process.stdin,
  output: process.stdout,
  prompt: 'You: ',
});

console.log('\nComposio Tool Router session created.');
console.log('\nChat started. Type your requests below.');
console.log("Commands: 'exit', 'quit', or 'q' to end\n");

try {
  const first = await run(agent, 'What can you help me with?', { session: conversationSession });
  console.log(`Assistant: ${first.finalOutput}\n`);
} catch (e) {
  console.error('Error:', e instanceof Error ? e.message : e, '\n');
}

rl.prompt();

rl.on('line', async (userInput) => {
  const text = userInput.trim();

  if (['exit', 'quit', 'q'].includes(text.toLowerCase())) {
    console.log('Goodbye!');
    rl.close();
    process.exit(0);
  }

  if (!text) {
    rl.prompt();
    return;
  }

  try {
    const result = await run(agent, text, { session: conversationSession });
    console.log(`\nAssistant: ${result.finalOutput}\n`);
  } catch (e) {
    console.error('Error:', e instanceof Error ? e.message : e, '\n');
  }

  rl.prompt();
});

rl.on('close', () => {
  console.log('\n👋 Session ended.');
  process.exit(0);
});
```

## Complete Code

```python
import asyncio
import os
from dotenv import load_dotenv

from composio import Composio
from composio_openai_agents import OpenAIAgentsProvider
from agents import Agent, Runner, HostedMCPTool, SQLiteSession

load_dotenv()

api_key = os.getenv("COMPOSIO_API_KEY")
user_id = os.getenv("USER_ID")

if not api_key:
    raise RuntimeError("COMPOSIO_API_KEY is not set. Create a .env file with COMPOSIO_API_KEY=your_key")

# Initialize Composio
composio = Composio(api_key=api_key, provider=OpenAIAgentsProvider())

# Create Tool Router session
session = composio.create(
    user_id=user_id,
    toolkits=["recallai"]
)
mcp_url = session.mcp.url

# Configure agent with MCP tool
agent = Agent(
    name="Assistant",
    model="gpt-5",
    instructions=(
        "You are a helpful assistant that can access Recallai. "
        "Help users perform Recallai operations through natural language."
    ),
    tools=[
        HostedMCPTool(
            tool_config={
                "type": "mcp",
                "server_label": "tool_router",
                "server_url": mcp_url,
                "headers": {"x-api-key": api_key},
                "require_approval": "never",
            }
        )
    ],
)

print("\nComposio Tool Router session created.")

chat_session = SQLiteSession("conversation_openai_toolrouter")

print("\nChat started. Type your requests below.")
print("Commands: 'exit', 'quit', or 'q' to end\n")

async def main():
    try:
        result = await Runner.run(
            agent,
            "What can you help me with?",
            session=chat_session
        )
        print(f"Assistant: {result.final_output}\n")
    except Exception as e:
        print(f"Error: {e}\n")

    while True:
        user_input = input("You: ").strip()
        if user_input.lower() in {"exit", "quit", "q"}:
            print("Goodbye!")
            break

        result = await Runner.run(
            agent,
            user_input,
            session=chat_session
        )
        print(f"Assistant: {result.final_output}\n")

asyncio.run(main())
```

```typescript
import 'dotenv/config';
import { Composio } from '@composio/core';
import { OpenAIAgentsProvider } from '@composio/openai-agents';
import { Agent, hostedMcpTool, run, OpenAIConversationsSession } from '@openai/agents';
import * as readline from 'readline';

const composioApiKey = process.env.COMPOSIO_API_KEY;
const userId = process.env.USER_ID;

if (!composioApiKey) {
  throw new Error('COMPOSIO_API_KEY is not set. Create a .env file with COMPOSIO_API_KEY=your_key');
}
if (!userId) {
  throw new Error('USER_ID is not set');
}

// Initialize Composio
const composio = new Composio({
  apiKey: composioApiKey,
  provider: new OpenAIAgentsProvider(),
});

async function main() {
  // Create Tool Router session
  const session = await composio.create(userId as string, {
    toolkits: ['recallai'],
  });
  const mcpUrl = session.mcp.url;

  // Configure agent with MCP tool
  const agent = new Agent({
    name: 'Assistant',
    model: 'gpt-5',
    instructions:
      'You are a helpful assistant that can access Recallai. Help users perform Recallai operations through natural language.',
    tools: [
      hostedMcpTool({
        serverLabel: 'tool_router',
        serverUrl: mcpUrl,
        headers: { 'x-api-key': composioApiKey },
        requireApproval: 'never',
      }),
    ],
  });

  // Keep conversation state across turns
  const conversationSession = new OpenAIConversationsSession();

  // Simple CLI
  const rl = readline.createInterface({
    input: process.stdin,
    output: process.stdout,
    prompt: 'You: ',
  });

  console.log('\nComposio Tool Router session created.');
  console.log('\nChat started. Type your requests below.');
  console.log("Commands: 'exit', 'quit', or 'q' to end\n");

  try {
    const first = await run(agent, 'What can you help me with?', { session: conversationSession });
    console.log(`Assistant: ${first.finalOutput}\n`);
  } catch (e) {
    console.error('Error:', e instanceof Error ? e.message : e, '\n');
  }

  rl.prompt();

  rl.on('line', async (userInput) => {
    const text = userInput.trim();

    if (['exit', 'quit', 'q'].includes(text.toLowerCase())) {
      console.log('Goodbye!');
      rl.close();
      process.exit(0);
    }

    if (!text) {
      rl.prompt();
      return;
    }

    try {
      const result = await run(agent, text, { session: conversationSession });
      console.log(`\nAssistant: ${result.finalOutput}\n`);
    } catch (e) {
      console.error('Error:', e instanceof Error ? e.message : e, '\n');
    }

    rl.prompt();
  });

  rl.on('close', () => {
    console.log('\nSession ended.');
    process.exit(0);
  });
}

main().catch((err) => {
  console.error('Fatal error:', err);
  process.exit(1);
});
```

## Conclusion

This was a starter code for integrating Recallai MCP with OpenAI Agents SDK to build a functional AI agent that can interact with Recallai.
Key features:
- Hosted MCP tool integration through Composio's Tool Router
- SQLite session persistence for conversation history
- Simple async chat loop for interactive testing
You can extend this by adding more toolkits, implementing custom business logic, or building a web interface around the agent.

## How to build Recallai MCP Agent with another framework

- [Claude Agent SDK](https://composio.dev/toolkits/recallai/framework/claude-agents-sdk)
- [Claude Code](https://composio.dev/toolkits/recallai/framework/claude-code)
- [Claude Cowork](https://composio.dev/toolkits/recallai/framework/claude-cowork)
- [Codex](https://composio.dev/toolkits/recallai/framework/codex)
- [OpenClaw](https://composio.dev/toolkits/recallai/framework/openclaw)
- [Hermes](https://composio.dev/toolkits/recallai/framework/hermes-agent)
- [CLI](https://composio.dev/toolkits/recallai/framework/cli)
- [Google ADK](https://composio.dev/toolkits/recallai/framework/google-adk)
- [LangChain](https://composio.dev/toolkits/recallai/framework/langchain)
- [Vercel AI SDK](https://composio.dev/toolkits/recallai/framework/ai-sdk)
- [Mastra AI](https://composio.dev/toolkits/recallai/framework/mastra-ai)
- [LlamaIndex](https://composio.dev/toolkits/recallai/framework/llama-index)
- [CrewAI](https://composio.dev/toolkits/recallai/framework/crew-ai)

## Related Toolkits

- [Gmail](https://composio.dev/toolkits/gmail) - Gmail is Google's email service with powerful spam protection, search, and G Suite integration. It keeps your inbox organized and makes communication fast and reliable.
- [Outlook](https://composio.dev/toolkits/outlook) - Outlook is Microsoft's email and calendaring platform for unified communications and scheduling. It helps users stay organized with powerful email, contacts, and calendar management.
- [Slack](https://composio.dev/toolkits/slack) - Slack is a channel-based messaging platform for teams and organizations. It helps people collaborate in real time, share files, and connect all their tools in one place.
- [Gong](https://composio.dev/toolkits/gong) - Gong is a platform for video meetings, call recording, and team collaboration. It helps teams capture conversations, analyze calls, and turn insights into action.
- [Microsoft teams](https://composio.dev/toolkits/microsoft_teams) - Microsoft Teams is a collaboration platform that combines chat, meetings, and file sharing within Microsoft 365. It keeps distributed teams connected and productive through seamless virtual communication.
- [Slackbot](https://composio.dev/toolkits/slackbot) - Slackbot is a conversational automation tool for Slack that handles reminders, notifications, and automated responses. It boosts team productivity by streamlining onboarding, answering FAQs, and managing timely alerts—all right inside Slack.
- [2chat](https://composio.dev/toolkits/_2chat) - 2chat is an API platform for WhatsApp and multichannel text messaging. It streamlines chat automation, group management, and real-time messaging for developers.
- [Agent mail](https://composio.dev/toolkits/agent_mail) - Agent mail provides AI agents with dedicated email inboxes for sending, receiving, and managing emails. It empowers agents to communicate autonomously with people, services, and other agents—no human intervention needed.
- [Basecamp](https://composio.dev/toolkits/basecamp) - Basecamp is a project management and team collaboration tool by 37signals. It helps teams organize tasks, share files, and communicate efficiently in one place.
- [Chatwork](https://composio.dev/toolkits/chatwork) - Chatwork is a team communication platform with group chats, file sharing, and task management. It helps businesses boost collaboration and streamline productivity.
- [Clickmeeting](https://composio.dev/toolkits/clickmeeting) - ClickMeeting is a cloud-based platform for running online meetings and webinars. It helps businesses and individuals host, manage, and engage virtual audiences with ease.
- [Confluence](https://composio.dev/toolkits/confluence) - Confluence is Atlassian's team collaboration and knowledge management platform. It helps your team organize, share, and update documents and project content in one secure workspace.
- [Dailybot](https://composio.dev/toolkits/dailybot) - DailyBot streamlines team collaboration with chat-based standups, reminders, and polls. It keeps work flowing smoothly in your favorite messaging platforms.
- [Dialmycalls](https://composio.dev/toolkits/dialmycalls) - Dialmycalls is a mass notification service for sending voice and text messages to contacts. It helps teams and organizations quickly broadcast urgent alerts and updates.
- [Dialpad](https://composio.dev/toolkits/dialpad) - Dialpad is a cloud-based business phone and contact center system for teams. It unifies voice, video, messaging, and meetings across your devices.
- [Discord](https://composio.dev/toolkits/discord) - Discord is a real-time messaging and VoIP platform for communities and teams. It lets users chat, share media, and collaborate across public and private channels.
- [Discordbot](https://composio.dev/toolkits/discordbot) - Discordbot is an automation tool for Discord servers that handles moderation, messaging, and user engagement. It helps communities run smoothly by automating routine and complex tasks.
- [Echtpost](https://composio.dev/toolkits/echtpost) - Echtpost is a secure digital communication platform for encrypted document and message exchange. It ensures confidential data stays private and protected during transmission.
- [Egnyte](https://composio.dev/toolkits/egnyte) - Egnyte is a cloud-based platform for secure file sharing, storage, and governance. It helps teams collaborate efficiently while maintaining data compliance and security.
- [Google Meet](https://composio.dev/toolkits/googlemeet) - Google Meet is a secure video conferencing platform for virtual meetings, chat, and screen sharing. It helps teams connect, collaborate, and communicate seamlessly from anywhere.

## Frequently Asked Questions

### What are the differences in Tool Router MCP and Recallai MCP?

With a standalone Recallai MCP server, the agents and LLMs can only access a fixed set of Recallai tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Recallai and many other apps based on the task at hand, all through a single MCP endpoint.

### Can I use Tool Router MCP with OpenAI Agents SDK?

Yes, you can. OpenAI Agents SDK fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Recallai tools.

### Can I manage the permissions and scopes for Recallai while using Tool Router?

Yes, absolutely. You can configure which Recallai scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

### How safe is my data with Composio Tool Router?

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Recallai data and credentials are handled as safely as possible.

---
[See all toolkits](https://composio.dev/toolkits) · [Composio docs](https://docs.composio.dev/llms.txt)