MotionHub supports the Model Context Protocol (MCP), an open standard that allows AI assistants like Claude to connect directly to your account and work with your projects, tasks, media, scripts, calendar, and more. Instead of switching between MotionHub and an AI tool, you can ask your assistant to read, create, and update data on your behalf using natural language.
To connect an AI assistant to MotionHub:
In your AI assistant (e.g. Claude), add MotionHub as an MCP server using the connection URL provided by your account administrator.
The assistant will open a MotionHub consent screen in your browser.
Sign in with your MotionHub credentials if not already signed in.
Review the permissions being requested and click Authorise to grant access.
The assistant is now connected and can work with your MotionHub data.
The connection uses OAuth 2.0 for security. You can revoke access at any time (see Security below).
Once connected, an AI assistant has access to the same data you do, organised into the following categories:
List, create, and update projects. Assign or remove team members and contacts. Update project status and roles.
List, create, update, and delete tasks across projects. Filter by status, assignee, or due date.
List and view media items with full Azure AI analysis results (keywords, topics, labels, detected objects, people, locations, brands). View transcripts, comments, and tags. Update descriptions and manage tags.
Semantic search — Search media using natural language. For example, asking for "clips where people discuss funding" will find media about financial topics, investment, and budgets even if those exact words do not appear. This uses AI-powered vector search across all media metadata and transcripts.
List, create, update, and delete scripts. Manage scenes within scripts: create, update, delete, and reorder scenes. Associate media with scenes, set in/out points, and update transcripts.
List, create, update, and delete calendar events. Manage groups and rows for organising the calendar layout. Assign and unassign team members and contacts from events. Check for scheduling conflicts before making assignments.
Create and manage kanban-style project boards. Create, update, and move cards between columns. Add comments, links, tasks, and files to cards. Set card images from uploads or article URLs.
List, create, and update company records. Manage company contacts and link companies to projects.
List, create, and update contact records across the account.
List, create, and update programmes that group related projects together.
List and view rushes logs that track raw footage metadata for projects. Read-only — rushes logs cannot be created or modified through the AI assistant.
Here are some examples of what you can ask an AI assistant connected to MotionHub:
"What projects am I working on?"
"Create a new project called Summer Campaign and set its status to active."
"Who is assigned to the Documentary project?"
"Add Sarah as an editor on the Music Video project."
"What tasks are due this week?"
"Create a task to review the rough cut, assign it to me, and set it due Friday."
"Mark the colour grading task as complete."
"Show me all tasks assigned to James across all projects."
"List all video media in the Documentary project."
"Find clips where people discuss funding." (semantic search)
"Show me the transcript for the interview with the CEO."
"What keywords were detected in the B-roll footage?"
"Tag all the drone shots with 'aerial'."
"Update the description of the opening sequence clip."
"Show me all scripts in the Documentary project."
"Create a new edit script called Rough Cut v2."
"Add a new scene to the edit script with visual description 'Wide shot of the city skyline at sunset'."
"Associate the interview clip with scene 3."
"What events are scheduled for next week?"
"Schedule a filming day on Thursday from 9am to 5pm at the studio."
"Is Sarah available on Friday? Check for conflicts before booking."
"Move the production meeting to Wednesday."
"Show me the cards in the To Do column of the Production board."
"Create a card called 'Location Recce' in the Planning column."
"Add a comment to the Casting card with the latest update."
"Move the Sound Design card to the Done column."
"List all companies in the account."
"Create a contact for John Smith at ABC Productions with email john@abc.com."
"What contact details do we have for the sound studio?"
MCP access requires a minimum account role of User. Users with Read & Comment or Marketplace account roles cannot connect an AI assistant.
Within projects, the AI assistant inherits your project role:
Owner, Admin, Manager, Editor — Full read and write access. Can create, update, and delete data.
Commenter, Reader — Read-only access. Can list, view, and search data but cannot create, update, or delete anything.
Admin — Required to assign or remove team members from a project.
Manager — Required to update a team member's project role.
The following items can be deleted through the AI assistant (with editor or above permission):
Tasks
Scripts and scenes
Calendar events, groups, and rows
Board cards, columns, boards, card comments, and card links
The following items cannot be deleted through the AI assistant:
Projects
Media files
Companies and contacts
Programmes
All actions taken by the AI assistant are logged in the project event timeline.
OAuth 2.0 — Connections use industry-standard OAuth 2.0 with PKCE. Your MotionHub password is never shared with the AI assistant.
Token-based access — The assistant receives a time-limited access token. Tokens can be refreshed automatically but can also be revoked.
Rate limiting — MCP requests are rate-limited to prevent abuse (1,000 requests per hour).
Revoking access — To disconnect an AI assistant, revoke its access token from your account settings or sign out of the OAuth session. The assistant will no longer be able to access your data until re-authorised.
Audit trail — Actions taken by the AI assistant are logged in the project event timeline, the same as actions taken through the MotionHub interface.
