Model Context Protocol (MCP)

Tella’s MCP server provides a standardized interface that allows any compatible AI assistant to access your Tella workspace. List videos, manage playlists, update metadata, and more - all through natural language.

Endpoint

https://api.tella.com/mcp

Setup

Claude Code
Claude Desktop
Cursor

Run this command in your terminal:

claude mcp add --transport http --scope user tella https://api.tella.com/mcp

Or for one-click install: Add Tella MCP ServerYou’ll be prompted to authenticate with your Tella account.

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "tella": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.tella.com/mcp"
      ]
    }
  }
}

Add to your MCP settings:

{
  "mcpServers": {
    "tella": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.tella.com/mcp"
      ]
    }
  }
}

Authentication

The MCP server uses OAuth 2.1 for authentication. When you first connect, you’ll be redirected to Tella to authorize access. The connection uses your Tella account permissions - you can only access videos and playlists in workspaces you belong to.

Available Tools

Videos

list_videos

get_video

Get video information. Returns summary fields by default. Use include flags for additional data.Parameters:

id (required): Video ID
includeTranscript (optional): Include transcript text
includeChapters (optional): Include chapter markers
includeThumbnails (optional): Include thumbnail URLs
includeExports (optional): Include export status

update_video

Update video metadata and settings.Parameters:

id (required): Video ID
name (optional): Video title
description (optional): Video description
playbackRate (optional): Default playback speed (0.5-2.0)
captionsEnabled (optional): Show captions by default
transcriptEnabled (optional): Show transcript tab
commentsEnabled (optional): Allow comments
downloadsEnabled (optional): Allow downloads
linkScope (optional): Access level - public, private, password, or embedonly
password (optional): Password for protected videos
searchEngineIndexingEnabled (optional): Allow search engine indexing

delete_video

Delete a video (moves to trash).Parameters:

id (required): Video ID

duplicate_video

Create a copy of a video.Parameters:

id (required): Video ID to duplicate
name (optional): Name for the duplicate

Playlists

list_playlists

List all playlists in your workspace.Parameters:

visibility (optional): Filter by personal or org
cursor (optional): Pagination cursor
limit (optional): Items per page (1-100, default: 20)

create_playlist

Create a new playlist.Parameters:

name (required): Playlist name
description (optional): Playlist description
emoji (optional): Emoji icon
visibility (optional): personal or org
linkScope (optional): Access level - public, private, or password
password (optional): Password for protected playlists

get_playlist

Get detailed information about a playlist.Parameters:

id (required): Playlist ID

update_playlist

Update playlist metadata and settings.Parameters:

id (required): Playlist ID
name (optional): Playlist name
description (optional): Playlist description
emoji (optional): Emoji icon
linkScope (optional): Access level
password (optional): Password for protected playlists
searchEngineIndexingEnabled (optional): Allow search engine indexing

delete_playlist

Delete a playlist.Parameters:

id (required): Playlist ID

add_video_to_playlist

Add a video to a playlist.Parameters:

playlistId (required): Playlist ID
videoId (required): Video ID to add

remove_video_from_playlist

Remove a video from a playlist.Parameters:

playlistId (required): Playlist ID
videoId (required): Video ID to remove

Example Prompts

Once connected, you can ask your AI assistant things like:

“List all my Tella videos”
“Get the transcript for video xyz”
“Create a playlist called ‘Product Updates’ and add my latest 3 videos”
“Make my onboarding video public and enable downloads”
“What videos do I have in the Sales playlist?”

Troubleshooting

Authentication Issues

If you’re having trouble authenticating, try clearing your MCP auth cache:

rm -rf ~/.mcp-auth

Then reconnect to trigger a fresh OAuth flow.

Connection Issues

Ensure you’re using a compatible MCP client. The server uses HTTP transport.

Getting Started

​Endpoint

​Setup

​Authentication

​Available Tools

​Videos

​Playlists

​Example Prompts

​Troubleshooting

​Authentication Issues

​Connection Issues