ShotGrid MCP Server

A Model Context Protocol (MCP) server that provides AI assistants with seamless access to Autodesk ShotGrid (Flow Production Tracking)

English | 简体中文

Python Version PyPI version License codecov Downloads

📖 Documentation | 中文文档

Overview

ShotGrid MCP Server enables AI assistants like Claude, Cursor, and VS Code Copilot to interact directly with your ShotGrid (Flow Production Tracking) data. Built on FastMCP, it provides a high-performance bridge between AI tools and production tracking workflows.

Demo

0. Configure ShotGrid MCP in Code Editor

Configure ShotGrid MCP in Code Editor

1. Query Task Schedule & Workload Visualization

Query Task Schedule & Workload Visualization

Prompt: Query the team's task schedule for the past week, calculate workload rate based on 8 hours per day, and visualize it in web format

2. Batch Create Assets & Assign Tasks

Batch Create Assets & Assign Tasks

Prompt: Batch create the recommended hero characters in the shotgrid Demo:Animation project, categorize them as characters, use the FilmVFX-CharacterAsset task template, assign tasks to Yang Zhuo, with start and end dates set to next week

3. TimeLog Statistics & Visualization

TimeLog Statistics & Visualization

Prompt: Query timelog data from shotgrid and visualize it in web format

4. Department Efficiency Statistics & Send to WeCom

Department Efficiency Statistics & Send to WeCom

Prompt: Calculate department efficiency and send the data to WeCom. Efficiency formula: Efficiency = Task bid / Timelog hours

More Examples

ShotGrid MCP Server Demo

Features

Category	Highlights
40+ Tools	Complete CRUD operations, batch processing, thumbnails, notes, playlists
Transport	stdio (local), HTTP (remote), ASGI (production)
Performance	Connection pooling, schema caching, lazy initialization
Deployment	FastMCP Cloud, Docker, uvicorn/gunicorn, any ASGI server
Platform	Windows, macOS, Linux

Quick Start

Installation

# Using uv (recommended)
uv pip install shotgrid-mcp-server

# Or using pip
pip install shotgrid-mcp-server

Configuration

Set your ShotGrid credentials:

export SHOTGRID_URL="https://your-site.shotgunstudio.com"
export SHOTGRID_SCRIPT_NAME="your_script_name"
export SHOTGRID_SCRIPT_KEY="your_script_key"

Usage

stdio Transport (Default) - For Claude Desktop, Cursor, etc.

uvx shotgrid-mcp-server

HTTP Transport - For Remote Access

uvx shotgrid-mcp-server http --host 0.0.0.0 --port 8000

MCP Client Configuration

Add the server to your MCP client configuration:

Claude Desktop

{
  "mcpServers": {
    "shotgrid": {
      "command": "uvx",
      "args": ["shotgrid-mcp-server"],
      "env": {
        "SHOTGRID_URL": "https://your-site.shotgunstudio.com",
        "SHOTGRID_SCRIPT_NAME": "your_script_name",
        "SHOTGRID_SCRIPT_KEY": "your_script_key"
      }
    }
  }
}

Cursor / VS Code / Other MCP Clients

{
  "mcpServers": {
    "shotgrid": {
      "command": "uvx",
      "args": ["shotgrid-mcp-server"],
      "env": {
        "SHOTGRID_URL": "https://your-site.shotgunstudio.com",
        "SHOTGRID_SCRIPT_NAME": "your_script_name",
        "SHOTGRID_SCRIPT_KEY": "your_script_key"
      }
    }
  }
}

HTTP Transport (Remote)

{
  "mcpServers": {
    "shotgrid": {
      "url": "http://your-server:8000/mcp",
      "transport": { "type": "http" }
    }
  }
}

Deployment

Method	Command / Setup
FastMCP Cloud	Deploy via fastmcp.cloud with `fastmcp_entry.py`
ASGI	`uvicorn shotgrid_mcp_server.asgi:app --host 0.0.0.0 --port 8000`
Docker	See Deployment Guide

See the Deployment Guide for detailed instructions.

Available Tools

This server provides 40+ tools for interacting with ShotGrid:

Category	Tools
CRUD	`create_entity`, `find_one_entity`, `search_entities`, `update_entity`, `delete_entity`
Batch	`batch_create`, `batch_update`, `batch_delete`
Media	`download_thumbnail`, `upload_thumbnail`
Notes	`shotgrid.note.create`, `shotgrid.note.read`, `shotgrid.note.update`
Playlists	`create_playlist`, `find_playlists`
Direct API	`sg.find`, `sg.create`, `sg.update`, `sg.batch`, and more...

Example Prompts

Once connected, you can ask your AI assistant:

"Find all shots updated last week in Project X"
"Create a playlist with yesterday's lighting renders"
"Add a note to SHOT_010 about the background lighting"
"Summarize time logs for the Animation department this month"

Development

# Clone and install
git clone https://github.com/loonghao/shotgrid-mcp-server.git
cd shotgrid-mcp-server
pip install -r requirements-dev.txt

# Run tests
nox -s tests

# Development server with hot reload
uv run fastmcp dev src/shotgrid_mcp_server/server.py:mcp

Documentation

See the /docs directory for detailed documentation.

Contributing

Contributions welcome! Please follow the Google Python Style Guide and write tests.

License

MIT

Architecture

flowchart TB
    subgraph Clients["🤖 MCP Clients"]
        direction LR
        CLAUDE["Claude Desktop"]
        CURSOR["Cursor"]
        VSCODE["VS Code"]
        AI["Other AI"]
    end

    subgraph MCP["⚡ ShotGrid MCP Server"]
        direction LR
        TOOLS["40+ Tools"]
        POOL["Connection Pool"]
        SCHEMA["Schema Cache"]
    end

    subgraph ShotGrid["🎬 ShotGrid API"]
        direction LR
        P["Projects"]
        S["Shots"]
        A["Assets"]
        T["Tasks"]
        N["Notes"]
    end

    Clients -->|"MCP Protocol<br/>stdio / http"| MCP
    MCP -->|"REST API"| ShotGrid

    style Clients fill:#2ecc71,stroke:#27ae60,color:#fff
    style MCP fill:#3498db,stroke:#2980b9,color:#fff
    style ShotGrid fill:#e74c3c,stroke:#c0392b,color:#fff