---
title: "List Media Files"
description: "List and search media files in the workspace with filtering, pagination, and sorting."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.speakai.co/llms.txt
> Use this file to discover all available pages before exploring further.

# List Media Files

Use the Speak AI MCP server tool `list_media` to list and search media files in the
workspace with filtering, pagination, and sorting.

## What does it do?

List and search media files in the workspace with filtering, pagination, and
sorting. Use filterName for text search, mediaType to filter by audio/video/text,
folderId for folder-specific results, and from/to for date ranges. Use the include
param to embed additional data (transcripts, speakers, keywords) inline with each
result, avoiding N+1 API calls. Returns mediaIds you can pass to `get_transcript`,
`get_media_insights`, or `ask_ai_chat`. For deep full-text search across
transcripts, use `search_media` instead.

## Parameters

`list_media` takes 11 parameters, all of them optional.

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `mediaType` | enum | No | Filter by media type: "audio", "video", or "text" |
| `page` | number | No | Page number for pagination (0-based, default: 0) |
| `pageSize` | number | No | Number of results per page (default: 25, max: 100). Page through larger sets rather than raising this. With include: ['transcription'] each result carries a full transcript, and an oversized response is rejected outright. |
| `sortBy` | string | No | Sort field and direction, e.g. "createdAt:desc" or "name:asc" |
| `filterMedia` | number | No | Filter: 0=Uploaded, 1=Assigned, 2=Both (default: 2) |
| `filterName` | string | No | Filter media by partial name match |
| `folderId` | string | No | Filter media within a specific folder |
| `from` | string | No | Start date for date range filter (ISO 8601) |
| `to` | string | No | End date for date range filter (ISO 8601) |
| `isFavorites` | boolean | No | Filter to only show favorited media |
| `include` | array of enum: transcription, keywords, speakers, sentiment, custom, fields | No | Additional data to include with each media item. Without this, only metadata is returned. Use 'transcription' to include full transcripts inline, 'speakers' for speaker details, 'keywords' for extracted keywords, etc. Avoids N+1 API calls when you need data for multiple files. |

## Behaviour

The Speak AI MCP server publishes these behaviour hints for `list_media`.

- Only reads data. Does not modify your workspace.
- Does not delete or overwrite existing data.
- Repeating an identical call is safe.
- Stays inside Speak AI. Does not reach other systems.

## Related

- [Media library](/mcp/tools/media/) lists the rest of the Media library category.
- [Tool reference](/mcp/tools/) lists every Speak AI MCP server tool.
- [MCP server](/mcp/) covers setup, supported clients, and what agents can do once
  connected.

Source: https://docs.speakai.co/mcp/tools/media/list_media/index.mdx