Overview

Recall.ai provides a managed MCP server for providing read-only access to Recall.ai workspaces, bots, calendars, bot logs, and developer documentation from MCP-compatible AI clients.

How to Set Up

Choose the Recall.ai region that matches your workspace:

Region	MCP URL
US East	`https://us-east-1.recall.ai/mcp`
US West	`https://us-west-2.recall.ai/mcp`
Europe	`https://eu-central-1.recall.ai/mcp`
Asia Pacific	`https://ap-northeast-1.recall.ai/mcp`

MCP clients that support remote HTTP MCP can connect directly to the MCP URL and discover authentication from it. Use recall-ai as the MCP server name in each client.

Cursor Example

{
  "mcpServers": {
    "recall-ai": {
      "url": "https://us-east-1.recall.ai/mcp"
    }
  }
}

Windsurf Example

{
  "mcpServers": {
    "recall-ai": {
      "serverUrl": "https://us-east-1.recall.ai/mcp"
    }
  }
}

Claude Desktop Example

In Claude Desktop:

Open Settings.
Go to Connectors.
Add a custom connector.
Use recall-ai as the connector name.
Use https://us-east-1.recall.ai/mcp as the connector URL.
Connect and complete the Recall.ai OAuth flow.

Claude Code Example

claude mcp add --transport http recall-ai https://us-east-1.recall.ai/mcp

Codex Example

codex mcp add recall-ai --url https://us-east-1.recall.ai/mcp

Autonomous Agents

We support using API tokens in order to authenticate autonomous agents. You'll want to pass your API key as a header, in the following format:
Authorization: Bearer <API_TOKEN>

For example, to configure with Codex

[mcp_servers.recall-ai]
url = "https://us-east-1.recall.ai/mcp"
http_headers = { "Authorization" = "Bearer <API_KEY>"}

Available Tools

The Recall.ai MCP server exposes read-only tools scoped to the workspace selected during authorization. If your account can access multiple workspaces, use list_workspaces to find the workspace ID and pass it as workspace_id to workspace-scoped tools.

Tool Name	Description	Use Case
`get_info`	Show the active Recall.ai account, workspace, organization, and API version.	Confirm API version before adopting calendar v2 endpoints.
`list_workspaces`	Show Recall.ai workspaces available to the authenticated account.	Find the workspace tied to a customer escalation.
`get_service_status`	Show current customer-visible Recall.ai service status by region or product area.	Confirm whether Teams bot failures match an outage.
`list_service_incidents`	List historical customer-visible Recall.ai status incidents by region, time, or product area.	Correlate yesterday's transcription failures with published incidents.
`list_rate_limits`	Show configured public API rate limits for a workspace.	Explain 429s on bot creation requests.
`list_webhook_endpoints`	List configured webhook destinations and subscribed event types.	Confirm bot.done is subscribed before debugging webhooks.
`create_webhook_endpoint`	Create a webhook destination and event subscriptions.	Route transcript.done events to a new integration.
`update_webhook_endpoint`	Update a webhook destination, subscriptions, description, or active state.	Pause deliveries to a failing webhook receiver.
`send_test_webhook_endpoint`	Send a test webhook event to a configured destination.	Confirm a receiver accepts recording.done test events.
`list_webhook_deliveries`	List webhook events and delivery attempts for a resource.	Trace why a recording.done webhook never arrived.
`list_bots`	Find bots by status, meeting, schedule, platform, or metadata.	Locate bots that hit a waiting-room timeout.
`get_bot`	Fetch detailed bot status, events, participants, chat, and metadata.	Explain whether participants joined before recording ended.
`list_recordings`	Find recordings by bot, upload, status, time range, or metadata.	Find recordings linked to a Desktop SDK upload.
`list_audio_mixed`	Find mixed-audio artifacts by recording, status, format, or metadata.	Confirm whether mixed audio is ready.
`get_recording_resource`	Fetch recording or transcript artifact details by ID.	Investigate a missing transcript or media artifact.
`list_calendars`	List calendars in a workspace, with filters for email, platform, and connection status.	Confirm whether a user's calendar is connected.
`get_calendar`	Show details for one calendar integration.	Explain why one integration stopped syncing meetings.
`list_calendar_events`	Find synced calendar events by calendar, time, deletion state, or update time.	Locate deleted events still linked to bots.
`get_calendar_event`	Show details for one synced calendar event.	Confirm whether an event's meeting URL changed.
`get_bot_calendar_events`	Show calendar events that scheduled a bot.	Trace an unexpected bot to its scheduled meeting.
`get_bot_logs`	Fetch customer-visible runtime logs for a bot.	Explain why a bot failed to join or record.
`get_workspace_logs`	Fetch customer-visible workspace logs for a time window.	Trace failed transcript API requests during an incident.
`list_docs`	Show available Recall.ai documentation and API reference pages.	Find the slug for a product guide.
`search_docs`	Search Recall.ai documentation and API reference pages.	Find docs for a specific endpoint or error.
`get_doc`	Fetch a Recall.ai documentation page by slug.	Read the guide for a known docs slug.

Examples in Action

Bot Debugging

User: "Why did bot 7d6ac4c3-69ef-49a4-a2d9-06723c0a235a fail to join?"
Assistant: [Uses get_bot and get_bot_logs]
Response: "The bot entered a fatal state after receiving a meeting access error..."

Documentation Search

User: "Find the docs for creating a meeting bot."
Assistant: [Uses search_docs, then get_doc]
Response: "The relevant guide is agent-quickstarts. It explains how to create a bot..."