# Rev AI

```json
{
  "name": "Rev AI",
  "slug": "rev",
  "url": "https://composio.dev/toolkits/rev",
  "markdown_url": "https://composio.dev/toolkits/rev.md",
  "logo_url": "https://logos.composio.dev/api/rev",
  "categories": [
    "ai & machine learning",
    "document & file management",
    "productivity & project management"
  ],
  "is_composio_managed": false,
  "updated_at": "2026-03-29T06:48:07.517Z"
}
```

![Rev AI logo](https://logos.composio.dev/api/rev)

## Description

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Rev AI MCP or direct API to transcribe audio, generate captions, create subtitles, and retrieve transcript status through natural language.

## Summary

Rev AI is a speech-to-text platform offering high-quality transcripts, captions, and subtitles. It's known for combining human expertise with AI for accurate, affordable results.

## Categories

- ai & machine learning
- document & file management
- productivity & project management

## Toolkit Details

- Tools: 11

## Images

- Logo: https://logos.composio.dev/api/rev

## Authentication

- **Api Key**
  - Type: `api_key`
  - Description: Api Key authentication for Rev AI.
  - Setup:
    - Configure Api Key credentials for Rev AI.
    - Use the credentials when creating an auth config in Composio.

## Suggested Prompts

- Transcribe uploaded "team_meeting.mp3" audio file
- Get caption file for latest transcript
- Check status of transcript for order 12345

## Supported Tools

| Tool slug | Name | Description |
|---|---|---|
| `REV_DELETE_CUSTOM_VOCABULARY` | Delete Custom Vocabulary | Tool to delete a completed custom vocabulary and its data. Use when you need to remove an unused vocabulary after confirming it's no longer needed. |
| `REV_DELETE_JOB_BY_ID` | Delete Job By ID | Tool to delete a completed transcription job and its data. Use when you need to permanently remove a finished job after confirming it's no longer needed. |
| `REV_GET_ACCOUNT` | Get Account | Tool to retrieve developer account details. Use after authenticating with Rev AI. |
| `REV_GET_CAPTIONS` | Get Captions | Tool to retrieve captions (SRT or VTT) for a completed Rev.ai transcription job. Use after confirming the job status is 'completed'. |
| `REV_GET_CUSTOM_VOCABULARY_DETAILS` | Get Custom Vocabulary Details | Tool to retrieve custom vocabulary processing details. Use when needing to fetch the status and submitted phrases for a specific custom vocabulary after creation. |
| `REV_GET_JOB_BY_ID` | Get Job by ID | Tool to fetch details of a transcription job by its ID. Use when confirming job status and metadata are accurate. |
| `REV_GET_LIST_OF_JOBS` | Get List of Jobs | Tool to get list of transcription jobs from the past 30 days. Use when you need to retrieve and paginate through recent transcription tasks. |
| `REV_GET_TRANSCRIPT_BY_ID` | Get Transcript by ID | Tool to retrieve the transcript of a completed Rev.ai job. Use after confirming job is complete. Supports JSON format (with timestamps and speaker info) or plain text format. |
| `REV_START_STREAM_TRANSCRIPTION` | Start Stream Transcription | Tool to start a WebSocket transcription stream. Use when you need real-time speech-to-text streaming via Rev.ai. |
| `REV_SUBMIT_CUSTOM_VOCABULARY` | Submit Custom Vocabulary | Tool to submit a custom vocabulary for improved speech recognition. Use when you want to process domain-specific terms asynchronously. |
| `REV_SUBMIT_TRANSCRIPTION_JOB` | Submit Transcription Job | Tool to submit a new transcription job. Use when you have a media URL or file bytes ready for async processing. |

## Supported Triggers

None listed.

## Installation and MCP Setup

### Path 1: SDK Installation

#### Path 1, Step 1: Install Composio

Install the Composio SDK
```python
pip install composio_openai
```

```typescript
npm install @composio/openai
```

#### Path 1, Step 2: Initialize Composio and Create Tool Router Session

Import and initialize Composio client, then create a Tool Router session
```python
from openai import OpenAI
from composio import Composio
from composio_openai import OpenAIResponsesProvider

composio = Composio(provider=OpenAIResponsesProvider())
openai = OpenAI()
session = composio.create(user_id='your-user-id')
```

```typescript
import OpenAI from 'openai';
import { Composio } from '@composio/core';
import { OpenAIResponsesProvider } from '@composio/openai';

const composio = new Composio({
  provider: new OpenAIResponsesProvider(),
});
const openai = new OpenAI({});
const session = await composio.create('your-user-id');
```

#### Path 1, Step 3: Execute Rev AI Tools via Tool Router with Your Agent

Get tools from Tool Router session and execute Rev AI actions with your Agent
```python
tools = session.tools
response = openai.responses.create(
  model='gpt-4.1',
  tools=tools,
  input=[{
    'role': 'user',
    'content': 'Transcribe the "meeting.mp3" audio file and summarize the main points.'
  }]
)
result = composio.provider.handle_tool_calls(
  response=response,
  user_id='your-user-id'
)
print(result)
```

```typescript
const tools = session.tools;
const response = await openai.responses.create({
  model: 'gpt-4.1',
  tools: tools,
  input: [{
    role: 'user',
    content: 'Transcribe the "meeting.mp3" audio file and summarize the main points.'
  }],
});
const result = await composio.provider.handleToolCalls(
  'your-user-id',
  response.output
);
console.log(result);
```

### Path 2: MCP Server Setup

#### Path 2, Step 1: Install Composio

Install the Composio SDK for Python or TypeScript
```python
pip install composio claude-agent-sdk
```

```typescript
npm install @composio/core ai @ai-sdk/openai @ai-sdk/mcp
```

#### Path 2, Step 2: Initialize Client and Create Tool Router Session

Import and initialize the Composio client, then create a Tool Router session for Rev AI
```python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
```

```typescript
import { Composio } from '@composio/core';

const composio = new Composio({ apiKey: 'your-api-key' });
const session = await composio.create('your-user-id');
console.log(`Tool Router session created: ${session.mcp.url}`);
```

#### Path 2, Step 3: Connect to AI Agent

Use the MCP server with your AI agent (Anthropic Claude or Mastra)
```python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Rev AI tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('Transcribe "sales_call.wav" and provide a bullet summary.')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
```

```typescript
import { openai } from '@ai-sdk/openai';
import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
import { generateText } from 'ai';

const client = await createMCPClient({
  transport: {
    type: 'http',
    url: session.mcp.url,
    headers: {
      'x-api-key': 'your-composio-api-key',
    },
  },
});

const tools = await client.tools();
const { text } = await generateText({
  model: openai('gpt-4o'),
  tools,
  messages: [{
    role: 'user',
    content: 'Transcribe "sales_call.wav" and provide a bullet summary.'
  }],
  maxSteps: 5,
});

console.log(`Agent: ${text}`);
```

## Why Use Composio?

### 1. AI Native Rev AI Integration

- Supports both Rev AI MCP and direct API based integrations
- Structured, LLM-friendly schemas for reliable tool execution
- Rich coverage for reading, writing, and querying your Rev AI data

### 2. Managed Auth

- Built-in OAuth handling with automatic token refresh and rotation
- Central place to manage, scope, and revoke Rev AI access
- Per user and per environment credentials instead of hard-coded keys

### 3. Agent Optimized Design

- Tools are tuned using real error and success rates to improve reliability over time
- Comprehensive execution logs so you always know what ran, when, and on whose behalf

### 4. Enterprise Grade Security

- Fine-grained RBAC so you control which agents and users can access Rev AI
- Scoped, least privilege access to Rev AI resources
- Full audit trail of agent actions to support review and compliance

## Use Rev AI with any AI Agent Framework

Choose a framework you want to connect Rev AI with:

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

## Related Toolkits

- [Google Drive](https://composio.dev/toolkits/googledrive) - Google Drive is a cloud storage platform for uploading, sharing, and collaborating on files. It's perfect for keeping your documents accessible and organized across devices.
- [Google Sheets](https://composio.dev/toolkits/googlesheets) - Google Sheets is a cloud-based spreadsheet tool for real-time collaboration and data analysis. It lets teams work together from anywhere, updating information instantly.
- [Composio](https://composio.dev/toolkits/composio) - Composio is an integration platform that connects AI agents with hundreds of business tools. It streamlines authentication and lets you trigger actions across services—no custom code needed.
- [Notion](https://composio.dev/toolkits/notion) - Notion is a collaborative workspace for notes, docs, wikis, and tasks. It streamlines team knowledge, project tracking, and workflow customization in one place.
- [Airtable](https://composio.dev/toolkits/airtable) - Airtable combines the flexibility of spreadsheets with the power of a database for easy project and data management. Teams use Airtable to organize, track, and collaborate with custom views and automations.
- [Google Docs](https://composio.dev/toolkits/googledocs) - Google Docs is a cloud-based word processor that enables document creation and real-time collaboration. Its seamless sharing and version history make team editing and content management a breeze.
- [Google Super](https://composio.dev/toolkits/googlesuper) - Google Super is an all-in-one suite combining Gmail, Drive, Calendar, Sheets, Analytics, and more. It gives you a unified platform to manage your digital life, boosting productivity and organization.
- [Asana](https://composio.dev/toolkits/asana) - Asana is a collaborative work management platform for teams to organize and track projects. It streamlines teamwork, boosts productivity, and keeps everyone aligned on goals.
- [Google Tasks](https://composio.dev/toolkits/googletasks) - Google Tasks is a to-do list and task management tool integrated into Gmail and Google Calendar. It helps you organize, track, and complete tasks across your Google ecosystem.
- [Linear](https://composio.dev/toolkits/linear) - Linear is a modern issue tracking and project planning tool for fast-moving teams. It helps streamline workflows, organize projects, and boost productivity.
- [Composio search](https://composio.dev/toolkits/composio_search) - Composio search is a unified web search toolkit spanning travel, e-commerce, news, financial markets, images, and more. It lets you and your apps tap into up-to-date web data from a single, easy-to-integrate service.
- [Jira](https://composio.dev/toolkits/jira) - Jira is Atlassian’s platform for bug tracking, issue tracking, and agile project management. It helps teams organize work, prioritize tasks, and deliver projects efficiently.
- [Clickup](https://composio.dev/toolkits/clickup) - ClickUp is an all-in-one productivity platform for managing tasks, docs, goals, and team collaboration. It streamlines project workflows so teams can work smarter and stay organized in one place.
- [Monday](https://composio.dev/toolkits/monday) - Monday.com is a customizable work management platform for project planning and collaboration. It helps teams organize tasks, automate workflows, and track progress in real time.
- [Perplexityai](https://composio.dev/toolkits/perplexityai) - Perplexityai delivers natural, conversational AI models for generating human-like text. Instantly get context-aware, high-quality responses for chat, search, or complex workflows.
- [Browser tool](https://composio.dev/toolkits/browser_tool) - Browser tool is a virtual browser integration that lets AI agents interact with the web programmatically. It enables automated browsing, scraping, and action-taking from any AI workflow.
- [Addressfinder](https://composio.dev/toolkits/addressfinder) - Addressfinder is a data quality platform for verifying addresses, emails, and phone numbers. It helps you ensure accurate customer and contact data every time.
- [Affinda](https://composio.dev/toolkits/affinda) - Affinda is an AI-powered document processing platform that automates data extraction from resumes, invoices, and more. It streamlines document-heavy workflows by turning files into structured, actionable data.
- [Agiled](https://composio.dev/toolkits/agiled) - Agiled is an all-in-one business management platform for CRM, projects, and finance. It helps you streamline workflows, consolidate client data, and manage business processes in one place.
- [Agility cms](https://composio.dev/toolkits/agility_cms) - Agility CMS is a headless content management system for building and managing digital experiences across platforms. It lets teams update content quickly and deliver omnichannel experiences with ease.

## Frequently Asked Questions

### Do I need my own developer credentials to use Rev AI with Composio?

Yes, Rev AI requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

### Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. [Learn more](https://docs.composio.dev/tool-router/overview).

### Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. [Learn more](https://trust.composio.dev).

### What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

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