Kitsu MCP Server

An MCP (Model Context Protocol) server that connects AI assistants like Claude to Kitsu — the open-source production management tool for animation, VFX, and game studios.

Built with FastMCP and the Gazu Python client.

Features

71 tools covering the full Kitsu production pipeline:

Category	Tools
Projects	List, overview, stats, create, close
Assets	List, details, create, update, delete, asset types, CSV import/export
Shots & Sequences	List, details, create, update, delete, batch create, CSV import/export, OTIO import
Tasks	List, details, create, batch create, assign, update status, set estimates, delete
Time Tracking	Add, set, get time spent
Comments	Add comments, list comment history
Previews	Upload preview, publish preview (status + comment + file in one)
Casting	Get/set shot casting, get asset casting
Team & People	List team, person tasks, create person, departments
Playlists	List, create, add entities, build movie
Budgets	List, create budgets and budget entries
Concepts	List, create concepts
Edits	List, create edits
Scenes	List, create scenes
Metadata	List and add custom metadata descriptors
Other	Search, notifications, task statuses, daily progress report

Requirements

• Python 3.10+
• A running Kitsu instance (self-hosted or cloud)
• A Kitsu user account with appropriate permissions

Installation

git clone https://github.com/INGIPSA/kitsu-mcp-server.git
cd kitsu-mcp-server
pip install -r requirements.txt

Configuration

The server requires three environment variables:

Variable	Description	Example
KITSU_HOST	Your Kitsu API URL	https://kitsu.yourstudio.com/api
KITSU_USER	Login email	artist@yourstudio.com
KITSU_PASSWORD	Login password	your-password

Usage

With Claude Code

Add to your Claude Code MCP config (~/.claude/claude_desktop_config.json or project-level .mcp.json):

{
  "mcpServers": {
    "kitsu": {
      "command": "python",
      "args": ["path/to/kitsu-mcp-server/server.py"],
      "env": {
        "KITSU_HOST": "https://kitsu.yourstudio.com/api",
        "KITSU_USER": "your-email@example.com",
        "KITSU_PASSWORD": "your-password"
      }
    }
  }
}

With Claude Desktop

Add the same config block to Claude Desktop's settings under MCP servers.

Standalone

export KITSU_HOST="https://kitsu.yourstudio.com/api"
export KITSU_USER="your-email@example.com"
export KITSU_PASSWORD="your-password"

python server.py

Example prompts

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

• "List all open projects in Kitsu"
• "Create shots SH010 through SH200 in sequence SQ01"
• "Upload this render as a preview for the lighting task on SH020"
• "What happened in the project in the last 24 hours?"
• "Assign the animation task on SH030 to anna@studio.com"
• "Add 4 hours of work on this task for today"
• "Export all shots to CSV"
• "Create a new playlist and add all shots from SQ01"
• "What are the budget entries for this project?"

Available tools

Read

• list_projects — List all open projects
• get_project_overview — Project overview with team, task types, asset types
• get_project_stats — Task statistics grouped by status
• list_assets — List assets (optionally filtered by type)
• get_asset_details — Asset details with tasks
• list_sequences — List sequences
• list_shots — List shots (optionally filtered by sequence)
• get_shot_details — Shot details with tasks and casting
• list_my_tasks — Tasks assigned to logged-in user
• list_tasks_for_entity — Tasks for a specific asset or shot
• get_task_details — Task details with comment history
• get_time_spent — Time entries for a task
• list_comments — Comments on a task
• get_shot_casting — Asset breakdown for a shot
• get_asset_casting — Shots an asset appears in
• list_team_members — Team members in a project
• get_person_tasks — Tasks for a specific person
• list_departments — All departments
• list_playlists — Playlists in a project
• list_task_statuses — Available task statuses
• list_notifications — Recent notifications
• search — Search entities by name
• daily_progress_report — Activity summary for last N hours
• list_concepts — Concepts in a project
• list_edits — Edits in a project
• list_scenes — Scenes in a project
• list_metadata_descriptors — Custom metadata fields
• get_budgets — Budgets for a project
• get_budget_entries — Entries in a budget
• export_assets_csv — Export assets to CSV
• export_shots_csv — Export shots to CSV

Create

• create_project — Create a new project
• create_asset_type — Create an asset type
• create_asset — Create an asset
• create_episode — Create an episode
• create_sequence — Create a sequence
• create_shot — Create a shot
• create_task — Create a task with optional assignees
• create_person — Create a new user
• create_department — Create a department
• create_playlist — Create a playlist
• create_budget — Create a budget
• create_budget_entry — Create a budget entry
• create_concept — Create a concept
• create_edit — Create an edit
• create_scene — Create a scene
• add_metadata_descriptor — Add a custom metadata field

Update

• update_task_status — Change task status with optional comment
• assign_task — Assign a person to a task
• set_task_estimate — Set time estimate for a task
• add_comment — Add a comment to a task
• set_shot_casting — Set which assets appear in a shot
• update_asset — Update asset description/metadata
• update_shot — Update shot description/frames/metadata
• add_time_spent — Add time spent on a task
• set_time_spent — Set time spent on a task
• add_person_to_department — Add person to department
• remove_person_from_department — Remove person from department
• add_entity_to_playlist — Add shot/asset to playlist

Batch

• batch_create_shots — Create multiple shots at once (e.g. SH010-SH200)
• batch_create_tasks — Add a task type to all shots/assets in a group

Preview

• upload_preview — Upload a preview file to a task
• publish_preview — Status + comment + preview in one step

Import/Export

• import_assets_csv — Import assets from CSV
• import_shots_csv — Import shots from CSV
• import_otio — Import timeline from OpenTimelineIO

Dangerous (require confirm=True)

• delete_shot — Delete a shot
• delete_asset — Delete an asset
• delete_task — Delete a task
• close_project — Close/archive a project
• build_playlist_movie — Build a movie from playlist

License

MIT License — see LICENSE.

Credits

• Kitsu by CGWire
• Gazu Python client by CGWire
• MCP by Anthropic