loonghao/shotgrid-mcp-server
If you are the rightful owner of shotgrid-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.
ShotGrid MCP Server is a high-performance server implementation for managing ShotGrid entities using the Model Context Protocol (MCP).
ShotGrid MCP Server
A Model Context Protocol (MCP) server that provides AI assistants with seamless access to Autodesk ShotGrid (Flow Production Tracking)
English |
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
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 |
See the 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 directory for detailed documentation.
Contributing
Contributions welcome! Please follow the Google Python Style Guide and write tests.
License
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
