Amara MCP server

Connect Amara to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Amara MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the send message tool in Amara
  • Use the list team members tool in Amara
  • Use the update video tool in Amara
  • Use the manage project tool in Amara
  • Use the list teams tool in Amara
  • Use the list videos tool in Amara

Supported Tools

send_message

Send Message

Send a message to an individual user or an entire team through the Amara messaging system. Provide either a user or a team as the recipient, not both.

list_team_members

List Team Members

List all members of a team with their roles. Results are paginated.

update_video

Update Video

Update a video's metadata such as title, description, thumbnail, or move it to a different team/project. Only provided fields will be updated.

manage_project

Manage Project

Create, update, or delete a project within a team. Projects organize team videos and can optionally have task workflows enabled.

list_teams

List Teams

List teams on the Amara platform. Returns paginated team details including visibility settings and policies.

list_videos

List Videos

Search and list videos on the Amara platform. Filter by team, project, or video URL. Results are paginated and sorted by the specified order.

delete_video

Delete Video

Permanently delete a video and all associated subtitles from the Amara platform. Requires team admin permissions for team videos.

manage_team

Manage Team

Create a new team or update an existing team's settings including name, description, visibility, and membership/video policies. For creation, provide "name" and "slug". For updates, provide "teamSlug" and the fields to change.

list_projects

List Projects

List all projects within a team. Projects organize videos and may have task workflows enabled.

get_video

Get Video

Retrieve detailed information about a specific video, including its metadata, URLs, and available subtitle languages.

delete_subtitles

Delete Subtitles

Delete all subtitle versions for a specific language on a video. Only allowed for team videos where the API user is a team admin.

subtitle_actions

Subtitle Actions

List available workflow actions or perform a workflow action on subtitles. Actions include save-draft, publish, approve, reject, etc. Available actions depend on team configuration and current subtitle state.

manage_subtitle_request

Manage Subtitle Request

Create, update, or delete subtitle requests for collaboration teams. Requests track subtitle work through a multi-stage workflow: subtitling, review, approval, and completion. Assignees and status can be managed.

upload_subtitles

Upload Subtitles

Upload or update subtitles for a video in a specific language. Provide subtitle content inline or via URL in any supported format. Optionally perform a workflow action (save draft, publish, approve, etc.) together with the upload.

team_languages

Team Language Preferences

Set preferred or blacklisted languages for a team. Preferred languages auto-create tasks for new videos. Blacklisted languages disallow subtitle creation.

manage_team_member

Manage Team Member

Add, update, or remove a team member. Use "add" to invite a user, "update" to change their role, or "remove" to remove them from the team.

list_subtitle_requests

List Subtitle Requests

List subtitle requests for a collaboration team. Filter by work status, video, language, project, or assignee. Requests represent subtitle work items tracking through subtitling, review, approval, and completion stages.

get_activity

Get Activity

View activity logs scoped to a video, team, or user. Activity types include video additions/deletions, subtitle version changes, URL changes, team membership changes, and more. Provide exactly one of videoId, teamSlug, or userIdentifier to scope the query.

list_languages

List Supported Languages

Retrieve the full list of languages supported by the Amara platform, with their BCP-47 codes and names.

list_subtitle_languages

List Subtitle Languages

List all subtitle languages available for a video, including their completion status, version count, and assigned reviewer/approver.

manage_application

Manage Team Application

List, view, approve, or deny membership applications for teams that use application-based membership policies. Provide applicationId to view/update a specific application, or omit it to list all applications.

get_subtitles

Get Subtitles

Fetch subtitles for a video in a specific language. Provides a downloadable subtitle file for non-JSON formats and returns subtitle content in the requested format (JSON, DFXP, SRT, VTT, SBV, SSA), along with metadata such as version, author, and title.

subtitle_notes

Subtitle Notes

List or add notes on a subtitle set for communication between collaborators during the editing process. Omit "noteBody" to list existing notes, or provide it to add a new note.

get_user

Get User

View a user's profile information including their name, biography, video count, languages, and avatar.

create_video

Create Video

Add a new video to the Amara platform by providing a URL from a supported provider (YouTube, Vimeo) or a direct file link. Optionally associate the video with a team and project.

list_subtitle_versions

List Subtitle Versions

List the version history for one video language, including version numbers, authors, creation dates, and publication state. Pass a versionNumber to get_subtitles to retrieve or download a specific revision.

Connect Amara to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Amara in Metorial. In your Metorial portal, enable the Amara MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Amara tools.

Run Amara through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Amara and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Amara tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Amara

Slack

Slack: connect with bot OAuth or user OAuth to work with messages, conversations, search, files, Canvases, Lists, profiles, reactions, reminders, and workspace productivity settings.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Gmail

Send, read, and search email messages with support for recipients, attachments, and HTML content. Create, update, and send drafts. Manage conversation threads and organize messages with labels. Search mailboxes using Gmail query syntax (from, to, subject, date, attachment filters). Manage filters and vacation responders, update the primary address's display name and signature, and view send-as aliases, forwarding addresses, and auto-forwarding status. Import and insert messages for migration.

Google Calendar

Create, read, update, and delete calendar events and calendars. Manage attendees, recurring events, and reminders. Check free/busy availability for scheduling. Share calendars and control access permissions. Create events from natural language text with quick add. Manage special event types like focus time, out of office, and working location. Subscribe to or remove calendars from a user's calendar list. Sync calendar changes incrementally.

Google Drive

Upload, download, create, copy, move, rename, trash, and permanently delete files and folders in Google Drive. Search for files using complex queries filtering by name, MIME type, owner, modification date, labels, and other metadata. Share files and folders with specific users, groups, or domains with role-based permissions (owner, writer, commenter, reader). Manage shared drives and their members. Export Google Workspace files (Docs, Sheets, Slides) to standard formats like PDF, DOCX, and XLSX. Track file revision history and restore earlier versions. Create, read, update, and delete threaded comments and replies on files. Read label definitions and search files by label. Browse the Drive apps installed for your account. Store app-specific data in a hidden per-user folder.

Technical notes for Amara

Manage video subtitles, captions, and translations on the Amara platform. Add and manage videos from YouTube, Vimeo, or direct URLs. Create, upload, download, inspect version history, and edit subtitles in multiple formats (DFXP, SRT, VTT, SSA, SBV) across any supported language. Perform subtitle workflow actions including saving drafts, publishing, approving, and rejecting. Add notes to subtitle sets for collaborator communication. Manage teams with configurable membership policies and role-based access control. Organize videos into projects, handle team membership applications, and configure team language preferences. Track and manage multi-stage subtitle requests with assignees, due dates, and workflow stages. View activity logs for videos, teams, and users. View user profiles, send messages to users or teams, and retrieve supported languages.

Frequently asked questions

Common questions about connecting Amara to AI agents with Metorial.

  1. How many tools does the Amara MCP server have?
    The Amara MCP server exposes 26 tools, including Send Message, List Team Members, Update Video. Each one is governed and traced through Metorial.
  2. Amara exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Amara MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Amara and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Amara MCP server yourself or use the hosted gateway.

Connect Amara to production AI agents

See how Metorial gives your team governed access to Amara, with tracing and security controls built in.