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. When authenticating using OAuth, you grant the MCP server access to all workspaces within your billing account (with optional granular scopes to configure what it can access).

How to Set Up

Choose the Recall.ai region that matches your workspace:

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:

1. Open Settings.
2. Go to Connectors.
3. Add a custom connector.
4. Use recall-ai as the connector name.
5. Use https://us-east-1.recall.ai/mcp as the connector URL.
6. 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.

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..."